











本 书 实战 性 很 强 ， 没有 宛 长 的 概念 讲解 ， 都 是 实际 项 目 中 
使 用 的 实用 技术 ， 比 如 验证 码 、 文 件 上 传 、 图 像 处 理 、 调 

区 wemw| 。 汪 、 安 全 、 绥 存 等 。 留言 板 、 博 客 、 论 坛 、 微 信 公 众 平台 
开发 4 个 实战 项 目 案例 ， 使 污 者 尽快 切入 ThinkPHP 企 业 级 
项 目 开发 。 
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PHP 是 一 种 通用 开源 脚本 语言 ， 开 源 、 跨 平台 、 易 于 使 用 ， 主 要 适用 于 Web 开发 领域 。MVC 模式 使 得 
PHP 在 大 型 Web 项 目 开发 中 耦合 性 低 、 重 用 性 高 、 可 维护 性 高 、 有 利于 软件 工程 化 管理 。 本 书 以 实用 性 为 
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的 示例 以 及 详尽 的 注释 ， 便 于 读者 的 理解 和 掌握 。 最 后 通过 4 个 完整 的 项 目 详细 介绍 了 Web 应 用 从 设计 到 
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PHP 是 一 种 免费 而 且 开 源 的 开发 语言 ， 开 源 、 跨 平台 、 易 于 使 用 、 学 习 门 槛 低 的 优点 已 
经 成 为 当前 Web 开发 中 的 最 佳 编程 语言 。ThinkPHP 作为 快速 、 简 单 的 面向 对 象 的 轻 量 级 PHP 
开发 框架 ， 已 经 成 长 为 国内 最 领先 和 最 具 影 响 力 的 Web 应 用 开发 框架 ， 众 多 的 典型 案例 确保 
可 以 稳定 用 于 商业 以 及 门户 级 的 开发 。 

本 书包 括 14 个 章节 , 作为 学 习 ThinkPHP 的 6 个 阶段 ， 从 ThinkPHP 入 门 到 可 以 独立 完成 
一 个 标准 化 的 Web 项 目 为 止 , 所 有 内 容 都 是 当前 Web 开发 中 常用 而 且 重要 的 内 容 , 全 书 基于 
模块 化 的 思想 设计 编写 ， 可 以 帮助 读者 深刻 理解 ThinkPHP 框架 。 本 书 全 部 知识 点 都 以 最 新 的 
ThinkPHP3.2.3 版 本 为 主 ， 详 细 介 绍 了 ThinkPHP 极其 相关 的 Web 技术 ， 可 以 帮助 读者 熟悉 并 
掌握 实用 的 ThinkPHP 技术 ， 其 中 包括 当前 比较 流行 的 模版 化 网 页 布局 、 路 由 、 缓 存 、 多 语言 
等 主流 技术 ,实用 性 非常 强 。 本 书 所 涉及 的 示例 全 部 在 服务 器 上 运行 通过 , 读者 在 学 习 和 工作 
中 ， 可 以 直接 使 用 本 书 给 出 的 一 些 示例 。 

本 书 编写 的 宗旨 是 让 读者 能 够 拥有 一 本 ThinkPHP 方面 的 学 习 和 开发 使 用 的 书籍 ， 本 书 力 
求 对 所 涉及 的 知识 点 讲解 到 位 , 让 读者 可 以 轻松 理解 并 掌握 。 对 于 几乎 每 个 知识 点 都 有 可 运行 
的 代码 配套 ， 所 有 代码 都 有 详尽 的 注释 及 说 明 。 在 大 部 分 章节 的 最 后 都 会 结合 一 个 实际 用 例 ， 
对 该 章 知识 进行 归纳 总 结 ， 能 够 帮助 读者 更 好 地 掌握 理论 知识 点 ， 提 高 实际 编程 能 力 。 

本 书 所 有 开发 实例 的 源 代码 托管 在 github 上 : 

https://github.com/xialeistudio/thinkphp-inaction 

读者 可 以 在 开发 中 直接 使 用 。 对 于 本 书 有 任何 疑问 ， 读 者 可 以 在 github 上 面 提问 ， 笔 者 
尽力 及 时 回答 读者 提问 ， 帮 助 读者 提高 编程 能 力 ， 解 决 读者 在 开发 中 遇 到 的 难题 。 








本 书 程序 开发 环境 


操作 系统 : Windows 10 企业 版 64 位 操作 系统 

Web 服务 器 : Apache 2.4.17 

开发 语言 : PHP 5.5.30 
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1 】 Mvc 模式 概述 


MVC 全 名 是 Model View Controller， 是 模型 (model ) 一 视图 (view) 一 控制 器 
(controller) 的 缩写 ， 一 种 软件 设计 典范 ， 用 一 种 业务 罗 辑 、 数 据 、 界 面 显 示 分 离 的 方法 组 织 代 
码 ， 将 业务 逻辑 聚集 到 一 个 部 件 里 面 ， 在 改进 和 个 性 化 定制 界面 及 用 户 交互 的 同时 ， 不 需要 重新 
编写 业务 逻辑 。MVC 被 独特 地 发 展 起 来 用 于 映射 传统 的 输入 、 处 理 和 输出 功能 在 一 个 逻辑 的 图 
形 化 用 户 界面 的 结构 中 。 

MVC 模式 是 一 种 使 用 MVC (Model View Controller， 模 型 -视图 -控制 器 ) 设计 创建 Web 应 
用 程序 的 模式 : 


@ Model (模型 ) : 应 用 程序 数据 定义 (例如 数据 表 字 段 ) 。 
@ View (视图 ) : 显示 数据 (例如 显示 用 户 列表 ) 。 
@ Controller (控制 器 ) : 处 理 输入 ( 例如 添加 一 个 用 户 ) 。 


Model 〈 模 型 ) 是 应 用 程序 中 用 于 处 理应 用 程序 数据 逻辑 的 部 分 。 通 常 模型 对 象 负责 在 数据 
库 中 存 取 数据 。 

View〔 视 图 ) 是 应 用 程序 中 处 理 数 据 显示 的 部 分 。 通 常 视 图 是 依据 模型 数据 创建 的 。 

Controller 〈 控 制 器 ) 是 应 用 程序 中 处 理 用 户 交互 的 部 分 。 通 常 控制 器 负责 从 视图 读 取 数 
据 ， 控 制 用 户 输入 ， 并 向 模型 发 送 数据 。 

MVC 分 层 有 助 于 管理 复杂 的 应 用 程序 ， 因 为 可 以 在 一 个 时 间 内 专门 关注 一 个 方面 。 例 如 ， 
可 以 在 不 依赖 业务 逻辑 的 情况 下 专注 于 视图 设计 ， 同 时 也 让 应 用 程序 的 测试 更 加 容易 。 

MVC 分 层 同 时 也 简化 了 分 组 开发 。 不 同 的 开发 人 员 可 同时 开发 视图 、 控 制 器 逻辑 和 业务 逻 
辑 。 
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.人 ThinkPHP 是 什么 


ThinkPHP 是 一 个 免费 开源 的 、 快 速 的、 简单 的 、 面 向 对 象 的 轻 量 级 PHP 开发 框架 ， 它 创 
建 于 2006 年 初 ， 遵 循 Apache2 开源 协议 发 布 ， 是 为 了 加 快 Web 应 用 开发 和 简化 企业 应 用 开发 而 
诞生 的 。ThinkPHP 从 诞生 以 来 一 直 秉 承 简洁 实用 的 设计 原则 ， 在 保持 出 色 的 性 能 和 至 简 的 代码 
的 同时 ， 也 注重 易 用 性 。 同 时 ，ThinkPHP 拥有 众多 的 原创 功能 和 特性 ， 在 社区 团队 的 积极 参与 
下 ， 在 易 用 性 、 扩 展 性 和 其 他 性 能 方面 不 断 优化 和 改进 ， 已 经 成 长 为 国内 最 领先 和 最 具 影 响 力 的 
Web 应 用 开发 框架 ， 众 多 的 典型 案例 确保 可 以 稳定 用 于 商业 以 及 门户 级 的 开发 。 




















1 搭建 PHP 开发 环境 


“ 工 欲 善 其 事 ， 必 先 利 其 器 ”， 在 学 习 PHP 脚本 编程 语言 之 前 ， 必 须 先 搭建 并 熟悉 PHP 运 
行 环境 ， 但 是 有 一 些 初 学 者 总 是 在 安装 环境 上 浪费 大 量 时 间 。 或 许 是 因为 过 于 追求 完美 ， 想 安装 
-个 完全 由 自己 掌握 的 开发 环境 ， 而 有 的 则 是 因为 刚 开始 学 习 ， 被 网 上 一 些 文章 所 误导 ， 在 
Linux 下 使 用 源 代码 编译 安装 LAMP 环境 ， 笔 者 觉得 这 些 事情 可 以 说 是 “本 末 倒 置 ” 了 ， 就 算是 
笔者 本 人 ， 要 在 Linux 下 编译 安装 LAMP 环境 也 需要 一 天 左右 。 对 于 初学 者 ， 可 能 会 因此 打击 
到 学 习 PHP 的 信心 ， 笔 者 觉得 这 是 得 不 偿 失 的 。 笔 者 建议 使 用 本 节 介 绍 的 方式 进行 PHP 开发 环 
境 的 搭建 ， 无 论 有 无 基础 ， 都 可 以 在 几 个 小 时 之 后 开始 编码 工作 。 

目前 网 上 提供 的 Windows 下 PHP 的 集成 环境 有 AppServ、phpStudy、WAMP 和 UPUPW 
等 ， 这 些 软件 之 间 的 差别 不 大 ， 都 是 集成 了 PHP、MySQL、Apache。 本 书 主要 以 UPUPW 为 
例 ， 介 绍 集成 环境 的 安装 和 配置 。 














1.3.1 获取 UPUPW 


本 书写 作 时 采用 Apache 版 UPUPW PHP5.5 系列 环境 包 1510， 这 个 工具 包 的 主要 软件 
如 下 : 
@ PHP5.5.30 


® Apache2.4.17 
® MariaDBl10.1.8 


下 载 地 址 : 
http://www.upupw.net/aphp55/n110.html 


软件 名 称 : 
UPUPW AP5.5-1510.7z 


1.3.2 安装 UPUPW 


01 进入 软件 下 的 文件 夹 ， 将 UPUPW_AP5.5-1510.7z 解压 ， 右 击 “upupw.exe” ， 选 择 
“以 管理 员 身 份 运行 ”， 打 开 软 件 ， 如 图 1-1 所 示 








图 1-1 


02 输入 “sl1” 开 启 全 部 服务 ， 如 图 1-2 所 示 








版 PHP5.5 


控制 面板 3 口 x 








图 1-2 


03 打开 浏览 器 ， 在 地 址 栏 输入 “localhost” 进 行 测试 ， 如 果 一 切 顺利 ， 看 到 如 图 1-3 所 示 
的 结果 ， 则 表示 安装 成 功 
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1.3.3 


1.3.4 





| - 5 


本 PHpReHUPUPWSEE x 


TO 


{UPUPW PHP 探 针 》 


UPUPW apache2handler PHP/5.5.30 包 含 以 上 查 件 ， 不同 PHP 夭 本 包含 查 件 不 同 ， 清 根据 过 安 在 UPUPW 硬 源 PHP 力 能 选项 开启 





Core bemath calendar ctype date ereg filer ftp hash icony json merypt SPL 


服务 器 域名 localhost MySQLi Client 当 件 已 开启 
服务 蝇 崇 口 -180 SQUite chenta 件 BH 启 
服务 器 环境 Apache/2.4.17 GD library 钥 件 已 开启 
PHP 运 行 环境 apachezhandler PHP/5.5.30 EXIF 信 息 喜 看 组件 已 开启 
PHP 配 本 文件 E\UPUPW_AP5.S\PHP5\phpjini Opensstj 议 组件 Bf 启 
当前 网 站 目录 EJUPUPW _AP5.S/htdocs Maryptn 记 处 理 组 件 BH 启 
服务 器 水 准时 2016-01-25 00:08:55 1IMAP 电 子 部 件 至 效 库 日 开启 
软件 管理 设置 PHP 详 续 信息 | phpMyAdmin 管 至 SendMail 电 于 邮件 支持 BH 启 
PHP 多 线程 组 件 PHP Zend 解 密 担 件 PHP 援 存 优化 姐 件 
PHP Pthreads ionCube Loader XCache ZendOPcache Memcache 
已 开启 未 开启 未 开启 未 开启 已 开启 


x 


€ 3 C Dlocalhost A RA 








图 1-3 


目录 结构 说 明 


Apache2: Apache 软件 目录 。 

Backup: upupw 配置 文件 的 备份 及 功能 目录 。 
ErrorFiles: 服务 器 错误 页 面 。 
FileZillaftp: FileZilla 服务 端 软件 目录 。 
htdocs: Apache Web 目录 。 

MariaDB: MariaDB 数据 库 目 录 。 
memcached: Memcached 软件 目录 。 
PHP5: PHP 软件 目录 。 

phpmyadmin: phpmyadmin 软件 目录 。 
sendmail: sendmail 软件 目录 。 

temp: 服务 器 临时 文件 目录 。 

upcore: upupw 核心 程序 目录 。 

vhosts: 虚拟 主机 目录 。 

xdebug: xdebug 软件 目录 。 

upupw.exe: upupw 主 程序 。 


添加 虚拟 主机 


虚拟 主机 是 在 网 络 服务 器 上 分 出 一 定 的 磁盘 空间 供用 户 放 置 站 点 、 应 用 组 件 等 ， 提 供 必要 的 


站 点 功能 、 数 据 存放 和 传输 功能 。 所 谓 虚拟 主机 ， 也 叫 “ 网 站 空间 ”， 就 是 把 一 台 运 行 


在 互联 网 





上 的 服务 器 划分 成 多 个 “虚拟 ”的 服务 器 ， 每 一 个 虚拟 主机 都 具有 独立 的 域名 和 完整 的 Intemet 
服务 器 (支持 WWW、FTP、E-mail 等 ) 功能 。 


打开 UPUPW 安装 文件 夹 ， 右 击 upupw.exe， 选 择 “ 以 管理 员 身 份 运行 ”， 如 图 1-1 所 
示 
输入 “1” 添 加 虚拟 主机 ， 输 入 主 域名 www.test.com， 额 外 域名 不 输入 ， 网 站 目录 留 空 


即 可 ，upupw 会 自动 建立 相关 目录 ， 最 后 按 回 车 键 即 可 ， 如 图 1-4 所 示 














图 1-4 


CI03 输入 “q” 返回 主 界面 ， 然 后 输入 “11” 打 开 “ 添 加 本 地 域名 解析 ”， 如 图 1-5 所 示 


HostsEditol 二 大 
| 中 Add doman “Edt 甘 Dekete | Save 们 Reoad Fnd ~ 
IP Address Domain Name Comment 
9 
口 102.54.94.97 rhino.acme.com source server 
口 38.25.63.10 Xacme.com x client host 
口 127.0.0.1 localhost 
OD:1 localhost 














图 1-5 











单 击 Add domain， 在 弹出 窗口 中 输入 数据 ， 字 段 说 明 如 下 : 
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@ IPAddress: IP 地 址 ， 输 入 127.0.0.1。 
@ Domain Name: 域名 ， 输 入 www.testcom。 
@ Comment: 注释 ， 留 空 即 可 。 


305 输入 完成 后 单 击 OK 即 可 ， 如 图 1-6 所 示 。 


































HostsEditor 二 也 x 
中 Add doman “Edt 器 Daete | save SReoad | -| Fnd - 
YP Address Domain Name Comment 


# Copyright (c) 1993-2009 Microsoft Corp. 


# This is a sample HOSTS file used by Microsoft TCP/IP for Wirdows. 

# This fle contains the mappings of JP addresses to host names. Each 
[entry should be kept on an rdividual ne The IP address should 

# be placed in the first Column followed by the corresponding host name. 
# The IP address and the host name should be separated by at least one 
# space, 








# Additionally, comments (such as these) may be inserted on individual 
# lines or following the machine name denoted by a '# symbol 

# For example: 

口 102.54.94.97 rhino.acme.com Source server 
口 38.25.63.10 Xacme.com x cient host 
# localhost name resolution is handled within DNS itself. 

口 127.0.0.1 locahost 

口 :1 locahost 

回 127.0.0.1 www.test.com 














Changes are not saved 


1-6 


单 击 Save 之 后 关闭 该 软件 以 及 upupw.exe。 


06 打开 浏览 器 ， 在 地 址 栏 中 输入 wwwtestcom， 进 行 测试 ， 如 果 一 切 顺利 ， 看 到 如 图 1-3 所 
示 结 果 ， 证 明 添加 虚拟 主机 成 功 ; 如 果 失 败 ， 请 重启 浏览 器 之 后 重 试 。 


1.3.5 ”安装 集成 开发 环境 PHPStorm 


AI) 打开 浏览 器 ， 在 地 址 栏 中 输入 https://www.jetbrains.com/phpstorm/download/ ， 单 击 
DOWNLOAD， 下 载 PHPStorm 安装 程序 。 

人 双击 打开 下 载 的 PhpStorm-10.0.3 ， 打 开 安 装 程序 ， 一 路 单 击 Next 即 可 。 默 认 程 序 安装 
在 C: \Program Files (x86)VetBrains\PhpStorm 10.0.3- 

人 3 打开 C: \Program Files (x86)JetBrains\PhpStorm 10.0.3\bin\PhpStorm.exe， 第 一 次 运行 
会 询问 你 一 下 有 没有 配置 文件 需要 导入 ， 这 里 直接 单 击 OK 即 可 。 

人 4 接 下 来 程序 会 要求 进行 注册 ， 有 条 件 的 用 户 可 以 去 官方 网 站 购买 ， 这 里 单 击 试用 即 可 。 

人 5 PHPStorm 官方 只 有 英文 版 本 ， 网 上 有 汉化 版 ， 笔 者 不 推荐 使 用 ， 有 时 候 会 引起 软件 前 
溃 。 至 于 使 用 英文 版 本 的 过 程 中 ， 对 于 程序 有 不 懂 的 地 方 ， 笔 者 建议 安装 一 个 有 道 词 
典 进行 翻译 。 
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1 . 纪 第 -个 ThinkPHP 程序 


GT01 打开 浏览 器 ， 在 地 址 栏 中 输入 “thinkphp.cn”， 打 开 ThinkPHP 官方 网 站 ， 在 网 站 右 侧 
单 击 “ThinkPHP3.2.3 完整 版 ”， 下 载 到 计算 机 。 

人 02 将 下 载 的 “thinkphp 3.2.3_full.zip” 解 压 到 你 的 upupw 目录 \vhosts\www.test.com 中 ， 
文件 结构 如 图 1-7 所 示 。 





oem wm 150. 
动 % 
Ra 








1-7 


本 J03 打开 浏览 器 ， 在 地 址 栏 输入 www.test.com 进行 测试 ， 如 果 一 切 顺利 ， 可 以 看 到 结果 ， 
如 图 1-8 所 示 。 





日 wwesteaom x 
€ 3 GD wwwtestcom 立 嘻 @gd= 
A EN DD NA IR DO ionic OW 口 mac OW DD nodds 站 Fm 口 2 区 疡 林 # 口 reac OA 口 pp Oe > 


欢迎 使 用 ThinkPHP ! 


版 本 V3.2.3 
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1 全” 应 用 结构 说 明 


1.5:1 


目录 说 明 


一 个 典型 的 ThinkPHP 应 用 目录 结构 如 下 : 





其 中 应 用 目录 Application 的 结构 如 下 : 





1.5.2 ”入 口 文 件 


几乎 所 有 的 PHP MVC 框架 都 会 采用 单一 入 口 〈 网 站 的 所 有 访问 都 会 经 过 该 文件 ) 进行 项 目 
访问 ，ThinkPHP 也 不 例外 。 
入 口 文件 主要 完成 以 下 事情 : 


定义 框架 路 径 、 项 目 路 径 。 

定义 调试 模式 和 应 用 模式 (可 选 ) 。 
定义 全 局 常量 (可 选 ) 。 

加 载 框架 入 口 文件 。 
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1.5.3 自动 生成 


细心 的 读者 可 能 会 发 现 ， 下 载 的 thinkphp 3.2.3_fullzip 解压 后 Application 目录 是 空 的 ， 而 
访问 wwwtestcom 之 后 会 发 现 该 目录 下 面 多 出 了 Common、Home、Runtime 目录 。 这 其 实 是 
ThinkPHP 自动 生成 的 ， 目 的 是 为 了 简化 开发 工作 ， 规 范 项 目 结构 。 而 每 个 目录 下 都 有 一 个 
index.html 文件 ， 打 开 这 个 文件 后 发 现 只 有 一 个 空格 ， 这 又 是 做 什么 的 呢 ? 这 也 是 ThinkPHP 为 
我 们 做 的 ， 目 的 是 为 了 安全 ， 因 为 有 些 Web 服务 器 可 能 没有 关闭 目录 访问 ， 如 果 一 个 目录 中 没 
有 默认 首页 (浏览 器 地 址 栏 未 指定 访问 文件 时 ， 服 务 器 自动 访问 的 文件 ， 一 般 为 index.php、 
index.html) 时， 整个 目录 会 显示 在 浏览 器 窗口 中 ， 有 害 网 站 安全 。 


1.5.4 ”模块 


ThinkPHP3.2 采用 模块 化 的 设计 ， 每 个 模块 之 间 相 对 独立 ， 每 个 模块 可 以 很 方便 地 印 载 和 部 
署 。 默 认 模 块 为 Home 模块 ， 如 果 想 添加 其 他 模块 ， 比 如 后 台 模块 ， 则 在 Home 目录 同 级 建立 
Admin 目录 即 可 。 一 个 典型 的 模块 目录 如 下 : 





1.5.5 ”控制 器 


当 我 们 访问 www.test.com 时 ， 浏 览 器 怎么 会 显示 出 “欢迎 使 用 ThinkPHP! ”字样 呢 ? 
简要 地 分 析 一 下 执行 流程 : 


个 Joi Web 服务 器 加 载 默认 首页 。 

人 2 ndex.php 加 载 ThinkPHPphp， 框 架 开 始 运行 。 

人 3 由 于 未 指定 模块 、 控 制 器 和 动作 ， 框 架 采 用 默认 配置 : Home 模块 、Index 控制 器 、 
index 动作 。 

人 4 根据 APP PATH 找到 Application 目录 ， 再 根据 模块 名 、 控 制 器 名 和 动作 名 找到 Home 
目录 下 的 IndexControllerclass.php， 并 执行 其 中 的 index 方法 ,我 们 可 以 打开 文件 查看 
一 下 代码 ,代码 如 图 1-9 所 示 。 
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术语 解释 


1. 项 目 
-个 完整 的 Web 程序 ， 最 少 包 括 应 用 目录 、 框 架 目录 、 入 口 文 件 三 者 ， 一 个 项 目 可 以 有 多 
个 应 用 和 多 个 入 口 文件 ， 但 是 一 个 入 口 文件 只 对 应 一 个 应 用 。 举 个 简单 的 例子 ， 有 个 留言 板 的 项 
目 ，Application 目录 和 index.php 组 成 前 台 应 用 ，Admin 目录 和 admin.php 组 成 后 台 应 用 ， 这 两 
个 应 用 都 属于 留言 板 项 目 。 


2. 应 用 
-个 入 口 文件 和 一 个 应 用 目录 构成 一 个 应 用 ， 应 用 之 间 逻 辑 上 是 相互 独立 的 。 
3. 模式 


应 用 运行 的 模式 ， 默 认为 Common， 也 就 是 普通 模式 。 此 外 ，ThinkPHP 还 支持 Lite、 云 引 
擎 模式 (如 SAE 云 引 擎 ，BAE 云 引擎 等 ) 、Api 模式 。 

4. 模块 

应 用 目录 中 除了 Runtime 目录 外 其 他 目录 都 是 一 个 模块 ，Common 模块 比较 特殊 ， 该 模块 不 
能 被 浏览 器 直接 访问 。 


5. 控制 器 
模块 目录 下 的 Controller 文件 夹 中 形 如 xxControllerclass.php 的 文件 ， 即 为 一 个 控制 器 。 
6. 动作 


控制 器 的 public 方法 都 是 动作 。 
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1 .7 小 


集成 环境 UPUPW 的 安装 和 使 用 
UPUPW 中 服务 的 启动 以 及 关闭 
虚拟 主机 的 添加 

PHPStorm 的 安装 

ThinkPHP 应 用 的 部 署 


本 章 需 要 扩展 的 内 容 : 


添加 一 个 ThinkPHP 模块 并 且 访问 成 功 


第 1 章 ThinkPHP 入 门 
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一 个 好 的 框架 应 该 是 灵活 的 、 低 耦合 的 ， 所 以 配置 系统 是 重要 的 也 是 必需 的 。 由 于 配置 一 般 
是 键 值 对 的 ， 例 如 设置 “网 站 标题 ”为 “我 的 第 一 个 ThinkPHP 网 站 ”， 用 配置 式 的 表示 方式 就 
是 : 


可 以 看 到 在 config-demo.php 中 输出 的 是 config.php 文件 中 的 内 容 ， 这 种 方式 比 起 之 前 在 





“<title></title>” 中 直接 写 “ 我 的 第 一 个 ThinkPHP 网 站 ”要 灵活 得 多 ， 假 设 以 后 需要 更 改 网 站 
标题 了 ， 只 需要 在 config.php 文件 中 更 改 ， 可 以 避免 第 二 种 方式 带 来 的 次 端 。 
ThinkPHP 提供 的 配置 跟 上 文 提 到 的 没 多 少 区 别 ， 核 心 都 是 基于 PHP 数组 的 。 


了. 1 配置 类 型 


在 ThinkPHP 中 ， 配 置 文件 都 是 自动 加 载 的 (也 就 是 不 用 显示 require) ， 加 载 顺序 为 

默认 配置 名 公共 配置 模式 配置 调试 配置 名 场景 配置 名 模块 配置 名 扩展 配置 动态 配 置 。 

加 载 顺 序 优先 级 从 左 往 右 依次 递增 ， 也 就 是 说 “动态 配置 ”是 最 高 优先 级 ， 如 果 左 边 的 配置 
和 右边 有 重复 ， 系 统 会 使 用 右边 的 值 。 





2.1.1 默认 配置 


默认 配置 是 ThinkPHP“ 大 道 至 简 ， 开 发 由 我 ”宗旨 的 核心 体现 ， 旨 在 减少 开发 者 的 编码 工 
作 而 设计 的 。 默 认 情 况 下 ， 该 配置 文件 路 径 为 ThinkPHP/Conf/convention.php， 对 于 一 个 新 的 
Web 项 目 ， 除 了 数据 库 配 置 可 能 要 自 定义 之 后 ， 几 乎 不 需要 额外 的 配置 定义 。 


2.1.2 ”公共 配置 


所 谓 公共 配置 ， 指 的 是 一 个 应 用 下 的 所 有 模块 都 会 加 载 的 配置 文件 。 默 认 情 况 下 ， 公 共 配 置 
的 文件 路 径 为 Application/Common/Conf/config.php。 


2.1.3 ”模式 配置 


在 第 1 章 中 介绍 过 模式 ， 这 里 就 不 袭 述 了 ， 举 个 例子 ， 我 们 在 本 地 开发 代码 的 环境 一 般 是 自 
己 搭建 的 PHP 环境 〈 本 书 中 为 UPUPW 集成 环境 ) ， 权 限 都 是 很 开放 的 。 但 是 如 果 项 目 部 署 到 
云 服 务 器 上 可 能 就 会 运行 错误 了 ， 国 内 大 部 分 云 服务 器 都 不 可 以 本 地 写 文件 ，ThinkPHP 默认 的 
Runtime 机 制 就 会 失效 。 另 一 个 例子 是 关于 数据 库 的 ，SAE 云 引擎 为 了 数据 库 的 安全 性 ， 
MySQL 连接 信息 全 部 以 常量 定义 ， 该 常量 是 通过 改变 PHP 环境 的 参数 设置 的 ， 如 果 在 本 地 使 用 
该 参数 也 会 出 错 ，ThinkPHP 没有 模式 定义 的 时 候 ， 开 发 者 就 需要 特别 小 心 配 置 文件 的 模式 了 ， 
如 果 不 小 心 把 本 地 配置 上 传 到 服务 器 将 会 导致 网 站 直接 出 错 ， 所 以 ThinkPHP 推出 了 “运行 模 
式 ” 配 置 。 模 式 配置 的 文件 路 径 为 Application/Common/Config/config_ 模式 名 称 .php ， 如 
Application/Common/Config/config sae.php。 
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2.1.4 调试 配置 


Web 程序 在 正式 上 线 都 是 在 本 地 开发 调试 的 ， 有 时 候 本 地 开发 需要 使 用 本 地 数据 库 ， 服 务 


器 上 需要 使 用 线 上 数据 库 ， 为 了 避免 冲突 问题 ，ThinkPHP 也 定义 了 “调试 配置 ”功能 ， 可 以 方 
便 地 配置 调试 模式 下 的 各 项 参数 ， 例 如 显示 页 面 请 求 信息 的 SHOW_PAGE TRACE 参数 ， 本 地 
开发 时 将 其 设置 为 true， 提 交 到 服务 器 时 设置 为 false 就 可 以 实现 开发 和 线 上 的 隔离 。 默 认 情况 
下 ， 调 试 配置 的 文件 路 径 为 Application/Common/Config/debug.php。 


2.1.5 场景 配置 


试想 这 么 一 个 场景 ， 笔 者 有 个 项 目 需要 在 公司 和 家 里 都 进行 开发 ， 家 里 安装 的 是 MySQL 数 


据 库 ， 而 公司 安装 的 是 SQL Server 数据 库 。 为 了 在 这 两 种 情况 下 都 进行 正常 开发 ， 笔 者 需要 经 
常 改 变数 据 库 配置 ， 为 了 解决 这 个 问题 ，ThinkPHP 还 提供 了 一 种 “场景 配置 ”， 在 入 口 文件 中 
定义 应 用 场景 ， 代 码 如 下 : 


define('APP STATUS', 'company');// 公 司 


ThinkPHP 就 会 自动 加 载 Application/Common/Conf/company.php 文件 。 
如 果 在 家 里 开发 ， 在 入 口 文 件 中 则 可 以 如 下 定义 : 


define('APP_STATUS', 'home');// 家 里 


ThinkPHP 就 会 自动 加 载 Application/Common/Confhome.php 文件 。 
与 模式 不 同 ， 场 景 只 会 影响 配置 文件 的 加 载 ， 而 模式 会 影响 整个 应 用 ， 例 如 临时 文件 的 


写 入 等 。 


2.1.6 ”模块 配置 


每 个 模块 都 会 自动 加 载 本 模块 的 配置 文件 ， 默 认 情 况 下 ， 模 块 配置 的 文件 路 径 为 


Application/ 模 块 名 /Conf/config.php。 


每 个 模块 支持 独立 的 模式 配置 和 场景 配置 。 


2.1.7 ”扩展 配置 


假设 有 这 么 一 个 Web 项 目 ， 后 台 账 户 采用 配置 文件 方式 而 不 是 数据 库 方式 进行 储存 ， 按 照 


上 文 的 思想 ， 需 要 用 配置 文件 保存 该 账号 信息 ， 但 是 将 该 数据 直接 写 在 主 配置 文件 中 〈 本 文 默 认 
公共 配置 文件 ) 似乎 不 妥 《〈 按 照 解 耦 原则 ， 该 文件 已 经 单独 存放 ) ， 这 时 候 可 以 新 建 一 个 
admin_user.php 文件 专门 用 来 存放 后 台 账 户 信息 ， 在 主 配置 文件 中 加 载 即 可 。 
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2.1.8 动态 配置 


假设 我 们 在 主 配置 文件 中 配置 请 求 超时 时 间 为 10 秒 ， 但 是 遇 到 耗 时 操作 时 ，10 秒 的 时 间 脚 
本 可 能 仍 未 运行 完毕 〈 例 如 在 浏览 器 中 进行 数据 库 的 备份 操作 ) ， 这 时 候 会 导致 脚本 异常 终止， 
有 损 用 户 体验 ， 此 时 我 们 可 以 通过 ThinkPHP 的 配置 操作 函数 临时 更 改 超时 时 间 ， 操 作 结束 后 再 
设置 回 原 值 。 


2 .2 配置 操作 


针对 配置 的 操作 无 非 读 写 而 已 ，ThinkPHP 提供 了 很 方便 的 配置 操作 函数 C (大 写字 母 
C) 。ThinkPHP 按照 2.1 节 的 顺序 加 载 完 配置 之 后 ， 配 置 全 局 有 效 ， 在 框架 作用 范围 内 (一 般 指 
应 用 目录 下 ) ， 所 有 配置 都 可 以 直接 使 用 C 函数 读 取 包括 ThinkPHP 默认 配置 ) 。 

在 UPUPW 的 htdocs 目录 中 新 建 一 个 Web 项 目 (笔者 的 Web 项 目 名 称 为 thinkphp- 
inaction) ， 目 录 结 构 如 下 : 


ThinkPHP 框架 放 在 入 口 文件 上 一 级 主要 是 为 了 多 个 项 目 共用 一 套 框架 ， 节 约 了 磁盘 空间 。 
入 口 文件 定义 如 下 《以 后 如 果 没 有 特殊 说 明 ， 项 目 入 口 文件 统一 为 该 文件 ) : 
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打开 浏览 器 ， 在 地 址 栏 输入 localhost/chapter-2 进行 测试 。 看 到 “欢迎 使 用 ThinkPHP! ” 字 
样 证 明 应 用 初始 化 成 功 。 


2.2.1 C 函数 


作为 配置 操作 的 一 个 重要 函数 ， 不 得 不 单独 提 下 C 函数 。 打 开 文 件 
ThinkPHP/Common/functions.php， 可 以 看 到 C 函数 定义 如 下 : 








可 以 看 到 ThinkPHP 的 注释 是 很 详尽 的 ， 就 算是 没有 使 用 过 C 函数 的 程序 员 ， 看 完 注释 之 后 
对 C 函数 的 使 用 方法 应 该 是 没有 问题 的 。C 语言 函数 算法 说 明 如 下 : 


(1) 定义 static $_config 变量 ，static 方式 定义 的 变量 本 次 请 求 内 全 局 有 效 。 

(2) 如 果 传 入 的 $name 为 空 ， 返 回 所 有 配置 ， 如 果 不 为 空 ， 进 入 第 3 步 。 

(3) 判断 $name 是 否 为 字符 串 ， 如 果 是 ， 进 入 第 4 步 ， 和 否则 进入 第 12 步 。 

(4) 判断 $name 中 是 否 有 “.”， 如 果 没有 ， 进 入 第 5 步 ， 否则 进入 第 8 步 。 

(5) 将 $name 转换 为 大 写 ， 如 果 $value 为 null， 进 入 第 6 步 ; 否则 进入 第 7 步 。 

(6) 判断 是 否 存在 名 为 Sname 的 配置 ， 如 果 存 在 ， 则 返回 该 配置 的 值 ， 否 则 返回 默认 值 。 

(7) 将 名 称 为 $name 的 配置 值 设 为 $value， 并 返回 null。 

(8) 将 $name 分 割 为 数组 ， 加 入 传 入 的 $name 为 “user.name ”， 分 割 完 之 后 $name 为 
[user’,"name’]。 

(9) 将 $name 数组 的 第 1 个 元 素 “user” 转 换 为 大 写 ， 如 果 传 入 的 $value 为 null， 则 进入 第 
10 步 ， 否 则 进入 第 11 步 。 

(10) 判断 是 否 存 在 $_config[$name[0]][$name[1]] 〈 本 例 中 为 $_config['user"][name"]) 的 配 
署 ， 如 果 存在 ， 返 回 $_config[$name[0]][$name[1]] 的 值 ， 和 否则 返回 null。 

(11) 将 名 称 为 $_config[$name[0]][$name[1]] (本 例 中 为 $_config['user*]['name”]〉 的 配置 值 
设 为 $value， 并 返回 null。 

(12) 如 果 $name 是 数组 ， 则 将 该 数组 的 全 部 键 名 转换 为 大 写 后 合并 到 全 局 配置 中 去 。 

(13) 最 后 返回 null 是 为 了 防止 非法 调用 函数 。 


通过 源码 分 析 发 现 ，ThinkPHP 的 配置 名 称 只 有 一 级 是 不 区 分 大 小 写 的 ， 也 就 是 说 
CCDATA_CACHE_TYPE7 和 C('data_cache type") 的 返回 值 是 相等 的 ， 但 是 二 级 配置 是 区 分 大 小 
写 的 ， 也 就 是 说 C(username) 和 C(‘userNAME’) 是 不 相等 的 ， 这 点 请 读者 注意 。 另 外 ， 关 于 无 限 级 
配置 ， 因 为 源码 中 可 以 看 到 ThinkPHP 在 对 配置 的 处 理 只 处 理 到 二 级 ， 不 支持 二 级 以 上 配置 。 

2.2.2 ” 读 取 配置 


打开 Application/Home/Controller/IndexController.class.php， 更 改 index 方法 中 代码 如 下 : 


I 
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刷新 浏览 器 ， 可 以 看 到 浏览 器 输出 了 “File”， 证 明 读 取 配置 成 功 ， 我 们 并 没有 配置 
DATIA_CACHE_ TYPE， 通 过 2.1 节 的 加 载 顺序 可 以 发 现 默认 配置 中 有 DATA_CACHE TYPE 的 
配置 。 

现在 开始 测试 公共 配置 的 加 载 ， 打 开 Application/Common/Conf/config.php ， 设 置 
DATA_CACHE _TYPE 如 下 : 





刷新 浏览 器 ， 可 以 看 到 浏览 器 输出 了 “Db”， 公 共 配置 已 经 覆盖 了 默认 的 配置 “File”。 
继续 编辑 该 文件 ， 这 次 添加 一 个 二 维 数组 ， 最 终 代码 如 下 : 





打开 Application/Home/IndexController.class.php， 编 辑 index.php 代码 如 下 : 











刷新 浏览 器 ， 可 以 看 到 浏览 器 输出 了 “usemame: admin, password: 123456”， 其 他 类 型 的 配 
置 读 取 操 作 与 本 节 一 致 。 


2.2.3 ”加 载 扩展 配置 
在 Application/Home/Conf 目录 下 新 建 admin_userphp， 文 件 内 容 如 下 : 





编辑 同 级 的 config.php， 内 容 如 下 : 
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编辑 Application/Home/Controller/IndexController.class.php， 代 码 如 下 : 





刷新 浏览 器 ， 如 果 看 到 如 图 2-1 所 示 结 果 ， 证 明 设置 成 功 。 


本 1ocalhost/thinkphp-inae x 

€ 3 C iDlocalhostthinkphp-inaction/cha 车 @ 国 O 
江 应 用 问 FE 濡 口 腾 R 回 工 上 站 ionic 问 前 端 四 mac 口 游戏 

Array ( [0] => Array ( [id] => 1 [username] => root [password] 








root ) [1] => Array ( [id] => 2 [username] => admin [password] 
admin ) ) 





2-1 
如 果 看 到 其 他 结果 ， 请 检查 文件 路 径 是 否 一 致 ， 如 果 仍 不 能 解决 问题 ， 请 前 往 github 提问 。 


2.2.4 写 入 配置 


C 函数 写 入 的 配置 属于 “动态 配置 ”， 也 就 是 最 高 优先 级 的 配置 ， 编 辑 
Application/Home/Controller/IndexController.class.php， 内 容 如 下 : 
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正式 输出 前 后 先 输出 “<pre> ”有 利于 排版 显示 。 
刷新 浏览 器 可 以 看 到 如 图 2-2 所 示 页 面 。 





1 ED x 
/一 !ocalhosvthinkphp-ina x WE 
€ 会 C IDIlocalhost/thinkphp-inactior/chz 安 器 @ 国 O 

















2-2 
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读者 可 能 注意 到 设置 后 的 配置 覆盖 掉 了 原来 的 值 ， 如 果 想 保留 原来 的 值 应 该 怎么 操作 呢 ? 
ThinkPHP 这 次 就 没有 提供 相关 函数 给 我 们 了 ， 我 们 可 以 利用 array_merge 函数 操作 。 
编辑 Application/Home/Controller/IndexController.class.php， 代 码 如 下 : 








刷新 浏览 器 ， 可 以 看 到 如 图 2-3 所 示 界 面 。 














和 的 和 ee o x 
/可 dhosihinkphp-ine x 
€ 全 C |Dlocalhost/thinkphp-inaction/chapter-2/ 人 窜 器 @ 国 0O 王 
各 于 月 门 E 污 门 舌 入 站 I 门 ionk 站 前 站 mac 站 有 又 门 nodejs 门 佐 亚 » 
设置 前 : 中 
Brey 
C 
a er 
[ial =>1 
[nsername] =》 root 
[password] =) root 
) 
口 -> srrar 
[ial 之 2 
[usernmme] -》adnin 
了》 
图 差 模式 设 于 后 
2 
rr 
[ial -> 1 
[usernmme] ~> root 
) 
言 并 模式 设 理 后 
可 
rr 
[ial -> 1 
[username] -> root 
oot 
[ =》 如 ray 
‘ 
[adl => 2 
[nsernane] => adnin 
re] = adnin 
) 
[a 如 ray 
[ial -> 1 
[ername] =) root 
[paseword] =) adnin 
) 











二 级 配置 的 写 入 操作 和 读 取 类 似 ， 这 里 笔者 就 不 资 述 了 。 


2 .3 小 结 


本 章 需 要 掌握 的 内 容 : 


@ 配置 的 加 载 顺序 
@ 配置 的 读 取 、 写 入 、 扩 展 
@ <pre> 格 式 化 输出 


本 章 需 要 扩展 的 内 容 : 


图 2-3 


@。 利用 递归 思想 编写 一 个 支持 无 限 级 配置 的 操作 函数 
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说 到 路 由 大 家 可 能 不 陌生 ，“ 路 由 器 ”应 该 是 大 家 听 到 过 最 多 跟 路 由 有 关 的 词语 了 ， 本 章 所 
谈 到 的 路 由 和 路 由 器 的 路 由 原理 是 一 致 的 。 所 谓 “ 路 由 ”， 用 自然 语言 来 说 ， 就 是 “ 找 路 ”， 从 
本 章 来 看 ， 就 是 浏览 器 访问 了 一 个 “不 存在 ”的 URL，ThinkPHP 通过 路 由 规则 将 其 正常 发 送 到 
相应 的 动作 执行 并 返回 。 

来 看 一 下 下 面 这 两 个 URL: 


urll 采用 的 是 QueryString (查询 字符 串 ) 的 模式 ，url2 采用 的 是 pathinfo 的 模式 ， 对 于 搜索 
引擎 来 说 ，URL1 是 很 明显 的 动态 链接 !， 而 URL2 则 更 接近 静态 链接 ?。 


3.1 uRL 的 三 种 模式 


从 SEO (搜索 引擎 优化 ) 的 角度 来 说 ，URL 有 动态 URL、 戎 态 URL、 伪 静态 三 种 ， 三 种 模 
式 各 有 优点 和 缺点 ， 在 学 习 ThinkPHP 的 路 由 之 前 ， 有 必要 好 好 了 解 三 种 URL 模式 ， 以 便 在 最 
适合 的 时 候 应 用 最 合适 的 模式 。 


3.1.1 动态 URL 


动态 URL (本 文中 也 指 动态 页 面 ) 是 在 服务 端 运 行 的 程序 、 网 页 ， 属 于 动态 网 页 。 它 们 会 
随 着 不 同 访问 者 、 不 同时 间 ， 返 回 不 同 的 网 页 ， 例 如 ASP、PHP、ASPNET、JSP 等 网 页 ， 它 们 
在 URL 中 可 能 会 出 现 “?、=、&” 这 样 的 符号 ， 用 来 传递 参数 ， 有 很 强 的 交互 性 。 但 是 由 于 有 
交互 性 ， 所 以 动态 网 站 一 旦 被 黑客 入 侵 ， 将 会 对 服务 器 产生 很 大 的 安全 隐患 。 此 外 ， 由 于 文件 是 
动态 的 ， 每 次 访问 都 需要 经 过 服务 器 的 编译 执行 ， 对 服务 器 有 一 定 的 负载 压力 。 


1. 动态 链接 又 称 动态 页 面 ， 即 指 在 url 中 出 现 “?、=、&” 这 样 的 符号 ， 并 以 “.apsx、.asp、jsp、.php” 等 
为 后 组 的 url。 

2. 静态 链接 又 称 静 态 页 面 ， 它 是 一 个 固定 的 网 址 ， 不 包含 任何 参数 或 代码 ， 通 常 以 “htm、.html、.shtml、.xml” 
为 后 级 。 





3.1.2 静态 URL 


静态 URL 〈 本 文 也 指 静态 页 面 ) 是 指 实际 存在 、 无 须 经 过 服务 器 编译 直接 加 载 到 客户 浏览 
器 上 的 文件 。 它 是 一 个 固定 的 网 址 ， 不 包含 任何 参数 或 代码 ， 通 常 以 htm、.html、.shtml、.xml 
为 后 绥 ， 最 大 的 优点 是 无 论 怎样 访问 都 只 是 让 Web 服务 器 将 该 文件 发 送 给 客户 端 ， 不 做 任何 的 
编译 操作 ， 访 问 速度 快 、 跨 平台 、 跨 服务 器 ， 大 大 地 提高 了 访问 速度 及 降低 了 部 分 安全 隐患 。 搜 
索引 擎 往往 对 静态 页 面 情 有 独 钟 ， 但 是 静态 文件 也 有 其 缺点 ， 由 于 文件 直接 存放 在 服务 器 磁盘 
上 ， 如 果 网 页 过 多 的 话 ， 服 务 器 磁盘 空间 会 占用 过 多 。 


3.1.3 伪 静 态 URL 


伪 静 态 URL 本 质 是 动态 页 面 ， 但 是 其 URL 看 起 来 可 能 如 下 : 

http://www.example.com/post/1 

它 充分 结合 了 静态 页 面 和 动态 页 面 的 优点 ， 解 决 了 静态 页 面 占用 较 大 磁盘 空间 的 问题 ， 也 能 
够 较 好 地 应 付 搜索 引擎 ， 一 般 情况 下 ， 使 用 该 模式 的 网 站 居多 。 但 是 伪 静 态 也 不 是 完美 的 ， 由 于 
伪 静 态 虽 然 “ 看 上 去 ” 像 静 态 的 ， 实 际 上 不 是 ， 到 底 发 送 什么 内 容 到 客户 端 由 Web 服务 器 来 判 
定 ， 所 以 CPU 占有 量 会 上 升 ， 当 访问 量 过 大 的 时 候 容 易 导 致 网 站 崩溃 。 


本 .2 ThinkpPHp 的 路 由 


3.2.1 路 由 模式 
ThinkPHP 的 路 由 支持 以 下 四 种 模式 : 


普通 模式 
pathinfo 模式 
rewrite 模式 
兼容 模式 


接 下 来 通过 一 个 具体 的 场景 来 分 析 这 四 种 路 由 模式 ， 假 设 用 户 访问 Home 模块 的 Index 控制 
器 的 index 方法 ， 这 四 种 模式 下 的 URL 如 下 : 


普通 模式 : http://www.example.com/index.php?m=home&c=index&a=index 
pathinfo 模式 : http://www.example.com/index.php/home/index/index 
rewrite 模式 : http://www.example.com/home/index/index 

兼容 模式 : http://www.example.com/index.php?s=home/index/index 
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可 以 看 到 普通 模式 和 兼容 模式 可 以 归 类 到 动态 URL 中 ，pathinfo 和 rewrite 模式 可 以 归 类 到 
伪 静 态 模式 中 。rewrite 模式 和 pathinfo 模式 的 区 别 在 于 前 者 没有 index.php， 有 HTTP 基础 的 读 
者 可 能 有 些 不 理解 ， 如 果 按 照 静态 页 面 的 处 理 方式 ，rewrite 模式 下 Web 服务 器 会 前 往 Web 目录 
下 的 home/index/index 查找 默认 首页 ， 如 果 存 在 则 发 送 给 浏览 器 ， 否 则 发 送 404 错误 页 面 。 

接 下 来 可 以 进行 测试 ， 观 察 这 四 种 URL 在 浏览 器 中 的 实际 情况 ， 请 将 www.example.com 替 
换 为 相应 的 Web 目录 (笔者 的 为 http://localhost/thinkphp-inaction》。 

在 Web 目录 下 新 建文 件 夹 chapter3， 按 照 第 2 章 的 方法 新 建 入 口 文件 ， 并 且 在 浏览 器 访问 
使 ThinkPHP 初始 化 。 

编辑 Application/Home/Controller/IndexController.class.php， 内 容 如 下 : 





文件 内 容 很 简单 ， 只 要 浏览 器 输出 “1” 证 明 访问 home/index/index 成 功 。 打 开 浏览 器 分 别 
测试 普通 模式 〈 见 图 3-1) 、pathinfo 模式 ( 见 图 3-2) 和 rewrite 模式 〈 见 图 3-3) 。 


/ 恒 ,ccalhoshinkphp-ina x 
€ 3 CDIlocalhost/thinkphp-inaction/chapter-3/index.phpzm=home&c=index&a=index 立 趾 @g@O 
洪 应 用 口 后 满口 岂 R 口 IR 门 ionic 口 机 门 mac OW 门 nodsjs DR 器 项 目 口 坎 件 门 react OBR Ophp 口 
1 





























3-1 
i 画 - 0o x 
/ 国 1ocalhosvthinkphp-ina x \ 
€ 3 G |D localhost/thinkphp-inaction/chapter-3/index.php/home/index/index 。 立 辐 @EO= 
有 DB OA OIR 口 ioni OR 口 mac Op 口 nodss Om OME Od 口 read OA Ophp Oae > 
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EE oo x 
导 404 类 志 页 面 -UPUPW 二 ”x 
€ © D localhost/thinkphp-inact hapt meyind | 路 Q@gO = 
应 用 门 后 六 门 条 和 门 工具 门 ionic 口 前 二 门 mac 癌 尖 克 门 nodejs 器 了 项 门 ] 项 目 门 软件 口 react 门 是 口 php 门 ae 


{未 找到 } 法 海 不 懂 爱 ~ 页 面 不 出 来 ! 





©2015 UPUPW 绿 外 








平台 All rights reserved 








3-3 
可 以 看 到 ，rewrite 模式 下 ， 已 经 访问 不 到 home/index/index 了 ， 观 察 URL 发 现 ，Web 服务 
器 在 home/index/index 目录 下 查找 默认 文件 了 。 这 时 候 就 需要 对 Web 服务 器 进行 URL 重 写 


在 chapter-3 下 级 目录 新 建文 件 “.htaccess”， 文 件 无 名 称 ， 扩 展 名 为 “htaccess”， 该 文件 
为 Apache 服务 器 的 分 布 式 配置 文件 (通俗 点 说 ， 就 是 每 个 站 点 可 以 单独 设置 ， 互 不 影响 ) ， 文 
件 结构 如 图 3-4 所 示 。 


thinkphp-inaction 





文件 内 容 如 下 : 
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文件 第 1 行 : 打开 重 写 引擎 。 

文件 第 2 行 和 第 3 行 : 如 果 请 求 文件 不 是 目录 而 且 不 是 文件 〈 证 明 服 务 器 上 没有 该 请 求 文件 
或 请 求 目录 ) 。 

文件 第 4 行 : 将 所 有 请 求 重 定向 到 当前 目录 下 的 index.php 文件 ，“L” 代 表 如 果 该 规则 成 
功 处 理 ， 则 不 继续 处 理 下 一 条 规则 。 

以 _http://localhost/thinkphp-inaction/chapter-3/home/index/index 为 例 ， 由 于 服务 器 上 并 不 存在 
home/index/index 目录 ， 故 Apache 将 请 求 参 数 “/home/index/index” 全 部 传 给 chapter-3/index.php 
文件 处 理 。 

打开 浏览 器 刷新 ， 可 以 看 到 如 图 3-5 所 示 界 面 。 





ee EB- 5 x 
/一 ccalhosvthinkphp-ine x 

所 3 © 0 localhost/thinkphp-inaction/chapter-3/home/index/index 交加 QQ 国 Os 
A DO EN OR IR 门 ioni OW mc ON Onodes Oo I ME OW reac I PIE php 中 we » 
1 




















图 3-5 


最 后 则 是 兼容 模式 的 测试 ， 结 果 如 图 3-6 所 示 。 





x 
/ 一 oealhosythinkphp-inae x WW 
€ 3 © Dlocalhost/thinkphp-inaction/chapter-3/index.php?s=home/index/index 六 器 QQ 国 O= 
Ge Mt eS ed se WR cles dBA el le De et ee eel Ee 
1 





2 
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3.2.2 ”路 由 配置 


要 使 用 ThinkPHP 的 路 由 功能 ， 只 要 Web 服务 器 支持 除 普通 模式 外 的 任何 一 种 模式 即 可 ， 
前 提 是 在 公共 或 模块 ) 配置 文件 中 启用 路 由 功能 。 
编辑 Application/Common/Conf/config.php， 内 容 如 下 : 





接 下 来 就 是 配置 路 由 规则 了 ， 在 模块 的 配置 文件 中 使 用 URL_ROUTE_RULES 参数 进行 配 
置 ， 配 置 格式 为 数组 ， 一 个 元 素 就 是 一 个 路 由 规则 ， 编 辑 Application/Home/Conf/config.php， 内 


容 如 下 : 





打开 浏览 器 访问 http://localhost/thinkphp-inaction/chapter-3/home/posts/2015/01/01， 结 果 如 图 
3-7 所 示 。 
一 Iocalhosvthinkphp-inae x WE 


€ 3 © | localhost/thinkphp-inaction/chapter-3/home/posts/2015/01/01 六 器 @ 国 0O= 
洪 应 用 四 内 丫 闫 和 丫 工 站 ionic 站 前 基站 mac 让 游戏 口 nodejs 回 杂 大 癌 项 上 口 软 4 站 react 口 B 口 php 品 ae * 

















图 3-7 
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ThinkPHP 已 经 将 请 求 地 址 路 由 到 Application/Home/ControllewIndexControllerclass.php 的 
index 方法 中 去 了 。 

为 了 测试 一 下 路 由 图 3-7 的 结果 是 否 是 ThinkPHP 路 由 导致 的 ， 编 辑 
Application/Common/Confrconfig php 文件 ， 内 容 如 下 : 





刷新 浏览 器 ， 可 以 看 到 如 图 3-8 所 示 结果 。 





看 -oOo x 
于 


€ 3 GD localhost/thinkphp-inaction/chapter-3/home/posts/2015/01/01 交加 QQ@ 国 OO 
瑟 而 有 DB ORR OINR 口 ionic ON 口 mac Ot Onodes Om OM OO Oreact OR Ophp Oo 


无 法 加 载 控制 器 :Posts | 


错 吴 位置 
FILE: E\UPUPW._APS.S\htdocs\thinkphp-inaction\ThinkpHP\Library\Think\App.class.php LINE: 101 


TRACE 
#0 EAUPUPW_ApS SNhtdocsvthinkphp-inaction\ThinkPHPNLibraryThinkAApp classphp(101): 
E(\xE6\x97\xAO\xE6\xB3\x95\xES\x8A\xXAO\xE8\xBD\xBD\xE6\x8E\xXA7..') 

















图 3-8 


路 由 定义 的 一 般 规则 是 : “路 由 表达 式 ”=>“ 路 由 地 址 和 参数 ”或 者 array(“ 路 由 表达 
式 ”，“ 路 由 地 址 ”，“ 传 入 参数 ”)。 

“路 由 表达 式 ” 指 “以 何 种 规则 ”匹配 浏览 器 中 的 地 址 ， 如 果 匹 配 成 功 ， 系 统 将 在 处 理 请 求 
的 同时 把 “ 传 入 参数 ”如 果 有 配置 ) 传 给 指定 的 动作 。 

ThinkPHP 的 路 由 规则 采用 顺序 遍历 方式 进行 ， 只 要 成 功 匹 配 一 条 匹配 的 路 由 ， 则 终止 继续 
匹配 。 

路 由 表达 式 支持 规则 路 由 、 正 则 路 由 、 静 态 路 由 。 


1. 规则 路 由 


'posts/:year/:month/:day' => 'Index/index'"， 是 一 个 典型 的 规则 路 由 ， 通 过 “:” 进 行 参数 匹配 ， 
如 果 匹 配 成 功 ， 则 将 该 位 置 的 参数 传 给 指定 的 动作 。 
编辑 Application/Common/Confyconfig.php 文件 ， 将 “false ”更 改 为 “true ”， 编 辑 








Application/Home/Controller/IndexController.class.php， 内 容 如 下 : 


= 





刷新 浏览 器 ， 可 以 看 到 如 图 3-9 所 示 结 果 。 
[| 


交加 OQ 加 0O= 











本 |ocalhosthinkphp-nae x Wn 
和 3 © |D localhost/thinkphp-inaction/chapter-3/home/posts/2015/01/01 
SAR Om Oh OIA Oionc ORs Omec OW Onodgs OB Om Oi Oreect OA Ophp Ooe » 





year:2015, nonth:01, day:01 











图 3-9 


ThinkPHP 已 经 将 URL 地 址 中 的 各 项 参数 传 给 相应 的 动作 ， 如 果 是 未 启用 路 由 的 状态 ， 需 要 
获取 year 、month 、day 参数 就 必须 访问 形 如 http://localhost/thinkphp-inaction/chapter- 


3/index.php?year=2015&month=01&day=01 这 样 的 URL 才 可 以 。 


2. 正则 路 由 
顾名思义 ， 正 则 路 由 就 是 利用 正则 表达 式 进行 “路 由 表达 式 ” 配 置 ， 至 于 正则 表达 式 相关 知 


识 ， 读 者 可 以 在 网 上 参考 相关 资料 。 
编辑 Application/Home/Conf/config.php， 内 容 如 下 : 
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请 注意 :正则 路 由 的 最 后 一 个 “1” 前 面 没有 “:”， 固 只 要 URL 匹配 成 功 ，day 参数 永远 为 


刷新 浏览 器 ， 可 以 看 到 如 图 3-10 所 示 的 结果 。 


一 1ocalhestthinkphpine x 

€ 3 & |D localhost/thinkphp-inaction/chapter-3/home/posts/2015/01/12 交加 QQ@ 国 0O = 
A OE OBR OIR 口 ioni OM Ome OW OD rodejs Dam 项 门 罗 人 Dreact OA Ophp ae > 
year:2015, month:01, day:l 














图 3-10 


正则 路 由 匹配 成 功 ， 所 以 day 为 1， 如 果 正 则 路 由 匹配 失败 ， 浏 览 器 将 输出 12。 
接 下 来 将 浏览 器 地 址 栏 URL 改 为 http://localhost/thinkphp-inaction/chapter- 
3/home/posts/2015/01/010， 刷 新 浏览 器 ， 可 以 看 到 如 图 3-11 所 示 的 结果 。 


/ 国 ecahonnhntphp-ina x 
€ 3 © |D localhost/thinkphp-inaction/chapter-3/home/posts/2015/01/121 安 串 @ 四 OO = 
洪 应 用 口 B 口 寺 WR 口 IR 站 ionic 口 间 六 器 mac OW DO nodejs 癌 好 硕 站 项 目 丫 软件 Dreact Oa Ophp Oae » 
year:2015, month:01, day:121 














图 3-11 


可 以 看 到 输出 的 day 为 “121”， 证 明 ThinkPHP 匹配 到 了 第 二 条 路 由 ， 这 就 是 正则 路 由 的 
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优势 ， 最 严格 的 匹配 模式 ， 路 由 配置 中 正则 表达 式 的 最 后 一 个 子 模式 为 “Qd{2})”， 该 正则 只 匹 
配 两 位 数字 ， 而 请 求 的 URL 地 址 中 最 后 一 个 参数 为 3 位 数字 ， 固 正则 路 由 匹配 失败 ， 系 统 使 用 
规则 路 由 。 


3. 静态 路 由 


静态 路 由 定义 中 不 包含 任何 动态 参数 ， 也 不 需要 遍历 路 由 规则 ， 所 以 路 由 效果 比 前 两 者 高 ， 
为 了 区 分 前 两 种 路 由 规则 ， 静 态 路 由 采用 URL_MAP_RULES 进行 定义 。 
编辑 Application/Home/Conficonfig.php， 内 容 如 下 : 





编辑 Application/Home/Controller/IndexController.class.php， 内 容 如 下 : 





在 浏览 器 中 访问 http://localhost/thinkphp-inaction/chapter-3/home/site/welcome， 可 以 看 到 如 图 
3-12 所 示 结 果 。 
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[= 
于 localhost/thinkphp-ins x 





€ 3 © 0 localhost/thinkphp-inaction/chapter-3/home/site/welcome 六 器 DO 
号 同上 口 二 口琴 IR Oionic OW mac OW OO nodes RM RB OH Oresct OA Ophp Oe 


seo 








图 3-12 


了 .了 小 结 


本 章 需 要 掌握 的 内 容 : 

@ ”区 分 ThinkPHP 四 种 路 由 模式 

@ ”规则 路 由 、 静 态 路 由 的 配置 

@ ”新 建 一 个 路 由 规则 ， 将 其 路 由 到 IndexController.class.php 的 second 方法 
本 章 需 要 扩展 的 内 容 : 


@ ”熟悉 正则 路 由 的 使 用 
@ ”熟悉 三 种 路 由 规则 的 匹配 模式 





作为 MVC 模式 中 最 核心 的 控制 器 ， 起 着 沟通 视图 和 模型 的 作用 。 一 个 好 的 MVC 架构 中 ， 
View 永远 不 应 该 直接 操作 Model， 而 应 该 通过 VieweControllereModel 的 方式 进行 操作 。 一 方 
面 减少 了 耦合 程度 ， 另 一 方面 在 将 来 对 View 进行 重 构 时 不 会 影响 到 Model。 

一 般 来 说 ，ThinkPHP 的 控制 器 就 是 一 个 类 ， 该 类 位 于 “模块 /Controller” 文 件 夹 下 ， 而 操作 
指控 制 器 的 一 个 public 方法 。 前 面 几 章 或 多 或 少 都 提 到 了 控制 器 ， 但 并 没有 深入 讲解 ， 笔 者 觉得 
单独 拿 出 来 讲 令 人 印象 更 深刻 。 


人 .1 控制 器 的 定义 


ThinkPHP 控制 器 的 定义 非常 简单 ， 满 足以 下 两 个 条 件 即 可 : 


(1) 文件 名 形 如 “xxxControllerclass.php” 并 存放 于 “模块 /Controller” 文 件 夹 下 ; 
(2) 继承 ThinkPHP 的 Controller 及 其 子 类 (有 时 候 我 们 需要 扩展 一 些 公用 方法 ， 但 又 不 能 
改动 框架 ， 所 以 需要 子 类 去 继承 系统 的 Controller， 以 该 子 类 作为 新 的 Controller 父 类 ) 。 
而 定义 动作 只 需要 在 控制 器 中 定义 公共 方法 即 可 ， 在 Web 目录 下 新 建 chapter-4 文件 夹 ， 新 
建 入 口 文件 并 完成 初始 化 。 
在 Application/Home/Controller 下 新 建 TestController class.php， 内 容 如 下 : 





ThinkPHP 实战 





打开 浏览 器 ， 访 问 http://localhost/thinkphp-inaction/chapter-4/home/test/test， 可 以 看 到 浏览 器 
输出 了 “您 访问 了 home/testtest”。 看 到 这 么 长 的 URL， 有 些 读者 可 能 会 有 点 不 知 所 措 ， 实 际 
上 ， 简 要 地 分 析 一 下 就 很 简单 了 。 


@ localhost: 主机 名 

thinkphp-inaction: ApacheWeb 目录 下 的 一 个 子 目录 
chapter-4: thinkphp-inaction 的 子 目 录 

home: 模块 名 

第 一 个 test: 控制 器 名 

第 二 个 test: 动作 名 


几乎 所 有 的 ThinkPHP 框架 的 链接 都 可 以 采用 这 种 方式 去 分 析 。 

如 果 我 们 试 着 访问 “http://localhostthinkphp-inaction/chapter-4/home/test”， 浏 览 器 会 输出 
“非法 操作 : index” 的 字样 ， 原 因 是 ThinkPHP 在 检测 到 未 输入 动作 名 时 ， 自 动 使 用 控制 器 的 
“index” 方 法 作为 动作 名 ， 但 是 TestController 未 定义 index 方法 ， 所 以 报错 ， 添 加 index 方法 后 
就 可 以 正常 访问 了 。 

动作 的 定义 上 文 已 经 提 到 过 ， 一 个 public 的 方法 就 是 一 个 可 以 被 浏览 器 访问 到 的 动作 ， 方 法 
名 即 动作 名 ， 但 是 请 注意 到 下 面 这 个 URL: “http://localhostthinkphp-inaction/chapter-4/home/testlist”， 
如 果 按照 上 文 提 到 的 在 TestController 中 添加 “public function list)”， 编 辑 器 会 直接 报错 ， 因 为 
“list” 是 PHP 关键 字 ， 遇 到 这 种 情况 的 时 候 就 需要 配置 “操作 方法 后 级 ”了 。 

编辑 Application/Home/Confrconfig.php， 内 容 如 下 : 





“ ACTION SUFFIX ”就 是 操作 后 缀 的 配置 项 名 称 ， 接 下 来 编辑 
Application/Home/Controller/TestController.class.php， 内 容 如 下 : 
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打开 浏览 器 访问 “http://localhost/thinkphp-inaction/chapter-4/home/test/list”， 可 以 看 到 浏览 器 
输出 了 “您 访问 了 home/testlist”， 证 明 操作 后 级 配置 成 功 。 


4 .2 前 置 操作 和 后 置 操作 


试想 这 么 一 种 场景 ， 有 一 个 控制 器 方法 是 需要 很 高 的 审计 安全 级 别 的 (比如 提现 系统 中 的 提 
现 操作 ) ， 这 时 候 对 这 种 操作 需要 完整 的 日 志 记录 。 一 般 的 做 法 是 在 该 方法 体 前 面 和 后 面 增加 日 
志 写 入 代码 。 但 是 该 方式 不 利于 项 目 解 厢 ， 毕 竞 日 志 记 录 不 是 提现 逻辑 ， 而 是 审计 逻辑 ， 此 时 
ThinkPHP 提供 的 “前 置 操作 和 后 置 操作 ”可 以 实现 该 需求 。 

前 署 操 作 和 后 置 操作 是 “可 选 ” 的 ， 如 果 存 在 则 自动 调用 ， 定 义 方 式 如 下 ， 编 辑 
Application/Home/Conf/config.php， 代 码 如 下 : 


编辑 Application/Home/Controller/IndexController.class.php， 代 码 如 下 : 


CD | 
局 
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在 浏览 器 中 访问 http://localhost/thinkphp-inaction/chapter-4/home/index ， 浏 览 器 会 输出 
“beforeindexafter”， 证 明 系 统 按照 顺序 调用 了 相应 方法 。 


4 .了 动作 参数 乡 定 


参数 绑 定 通过 直接 绑 定 URL 地 址 中 的 变量 不 包括 模块 名 、 控 制 嚣 名、 动作 名 ) 为 操作 方 
法 的 函数 形 参 ， 可 以 简化 方法 定义 。 动 作 参 数 绑 定 是 默认 开启 的 ， 如 果 需 要 关闭 可 以 配置 
“URL PARAMS BIND” 为 “false”。 

在 前 面 的 内 容 中 ， 如 果 需 要 在 动作 中 获取 GET 参数 ， 需 要 使 用 $_GET 数组 ， 而 使 用 动作 参 
数 绑 定之 后 就 不 需要 使 用 GET 了 。 

编辑 Application/Home/IndexController.class.php， 代 码 如 下 : 














新 增 的 bind 方法 使 用 “动作 参数 绑 定 ”， 此 处 简单 输出 URL 变量 中 的 id 值 ， 在 浏览 器 
访问 http://localhost/thinkphp-inaction/chapter-4/home/index/bind/id/1， 浏 览 器 输出 “1”。 

需要 注意 的 是 ， 如 果 使 用 了 “动作 参数 绑 定 ”的 动作 形 参 未 指定 默认 值 ， 访 问 的 时 候 URL 
中 必须 包含 该 变量 ， 和 否则 系统 提示 “参数 错误 或 者 未 定义 ”。 打 开 浏 览 器 访问 
http://localhost/thinkphp-inaction/chapter-4/home/index/bind ， 浏 览 器 输出 “参数 错误 或 者 未 定 

解决 此 问题 的 方法 是 给 相应 参数 添加 默认 值 ， 更 改 后 的 bind 方法 代码 如 下 : 





打开 浏览 器 访问 http://localhost/thinkphp-inaction/chapter-4/home/index/bind ， 浏 览 器 输出 


«1» 


及 
ST。 和 SF 伪 静 态 


伪 戎 态 通常 是 为 了 优化 SEO 效果 ，ThinkPHP 支持 伪 静 态 设 置 ， 通 过 配置 
“URL_HTML SUFFIX” 可 以 在 URL 的 最 后 添加 你 想 要 的 静态 后 级 。 例 如 ， 配 置 
“URL_HTML SUFFIX” 为 “html” 时 ， 可 以 把 http://localhost/chapter-4/home/index/index 变 成 
http://localhost/chapter-4/home/index/index.html， 从 形式 上 看 ， 后 者 似乎 是 个 静态 URL。 

默认 情况 下 ，“URL_ HTML _SUFFIX” 为 “html”， 如 果 不 需 要 设置 伪 静 态 后 级 ， 将 
“html” 更 改 为 “” 即 可 ; 如 果 需 要 支持 多 个 伪 静 态 后 级 ， 将 “html” 更 改 为 “htmllhtm” 即 
可 ; 如 果 需 要 获取 当前 URL 的 伪 静 态 后 级 ， 直 接 使 用 “_EXT_ ”常量 即 可 。 

如 果 需 要 禁止 特定 后 级 的 访问 ， 配 置 “URL_DENY_SUFFIX” 即 可 。 例 如 ， 系 统 需 要 屏蔽 
图 片 链 接 ， 可 配置 “URL_DENY_SUFFIX” 为 “jpglpnglgif”， 如 果 访 问 http://localhost/chapter- 

4/home/home/index/index.jpg 会 返回 404 错误 

注意 : 


@ URL DENY_SUFFIX 优先 级 高 于 URL _HTML _SUFFIX.。 
@ 不 经 过 框架 处 理 的 请 求 URL_DENY_SUFFIX 不 会 生效 ， 比 如 在 chapter-4 目录 下 新 建 
“images” 文 件 夹 ， 在 文件 夹 中 放 入 “1.jpg”， 打 开 浏 览 器 访问 http://localhost/chapter- 
Wimages/1.jpg 时 ， 图 片 可 以 正常 显示 ， 因为 法 清 东 末 入 过 ThinkPHP 处 理 。 


外. 与 URL 大 小 写 


ThinkPHP 根据 URL 中 的 模块 名 、 控 制 器 名 来 定位 到 具体 的 控制 器 类 文件 ， 根 据 操作 名 执行 
相应 的 控制 器 方法 。 在 Windows 和 Linux 下 ， 文 件 名 大 小 写 会 影响 文件 的 查找 ， 来 看 以 下 的 例 
了: 

访问 http://localhost/chapter-4/index.php/Home/Index/index， 系 统 会 查找 Home/Controller/Index 
Controllerclass.php 文件 。 由 于 Windows 下 文件 名 大 小 写 不 敏感 ， 所 以 以 下 URL 都 是 等 效 的 


® http://localhost/chapter-4/index.php/home/Index/index 
® http://localhost/chapter-4/index.php/Home/index/index 
® http://localhost/chapter-4/index.php/Home/Index/Index 


如 果 在 Linux 环境 下 面 ， 一 旦 大 小 写 不 一 致 ， 就 会 造成 ThinkPHP 查找 不 到 对 应 的 文件 。 假 
设 请 求 的 URL 是 http://localhost/chapter-4/index.php/home/Index/index ， 系统 会 查找 
home/ControllerIndexControllerclass.php， 但 是 Home 模块 的 文件 夹 名 称 为 Home， 控 制 器 查找 时 
失败 ， 会 出 现 “Index 控制 器 不 存在 的 错误 ”。 

ThinkPHP 提供 了 一 个 “URL_CASE INSENSITIVE” 的 配置 项 ， 将 该 项 配置 为 “true” 即 可 
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实现 URL 不 区 分 大 小 写 ， 保 持 Windows 和 Linux 环境 的 一 致 体验 。 


A.6 URL 生 成 


ThinkPHP 一 个 强大 之 处 在 于 可 以 根据 不 同 的 URL 模式 来 生成 不 同 的 URL 地 址 ， 为 此 
ThinkPHP 提供 了 “U” 函 数 ， 该 函数 确保 了 项 目 在 移植 过 程 中 不 受 运行 环境 的 影响 。 
U 方法 定义 如 下 : 


4.6.1 ”地址 表达 式 
地 址 表达 式 格式 如 下 : 


如 果 没 有 指定 模块 名 ， 则 ThinkPHP 使 用 当前 模块 名 ， 来 看 以 下 例子 : 


4.6.2 ”参数 
参数 支持 数组 和 查询 字符 串 形式 ， 所 以 以 下 方式 是 等 效 的 : 


® U('User/view’,array("id’=>1,‘role’=>‘admin’)) 
® UUser/view’,"id=l&role=admin’) 
4.6.3 ” 伪 静 态 后 组 


该 参数 为 true 时 ， 系 统 读 取 URL_HTML _SUFFIX 配置 来 生成 URL， 如 果 需 要 临时 使 用 新 
规则 ， 可 以 直接 加 参数 后 级 名 ， 例 如 : 


4.6.4 ”URL 模式 处 理 
不 同 的 URL_MODEL 会 导致 生成 不 同 的 URL 地 址 ， 以 U(*Blog/view’,array('id’=>1),‘shtml’) 
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为 例 。 
普通 模式 : 


pathinfo 模式 : 


rewrite 模式 : 


兼容 模式 : 


如 果 “URL_ CASE_INSENSITIVE” 为 “tmue”，ThinkPHP 会 将 生成 结果 统一 转换 为 小 写 。 


4.6.5 生成 路 由 地 址 
假设 定义 了 以 下 路 由 规则 : 


那么 可 以 使 用 UC/blog/1") 来 生成 /index.php/Home/blog/1.shtml。 


不 .7 Ajax 返回 


在 接口 开发 中 ， 需 要 直接 返回 json 或 xml 格式 的 数据 ， 而 不 是 泻 染 视图 ， 编 辑 
Application/Home/Controller/IndexController.class.php， 代 码 如 下 : 





村 第 4 章 控制 器 








访问 http://localhost/chapter-4/home/index/index， 输 出 “f{"'status":1,"data":"data"} ”。 


系统 默认 返回 JSON 格式 的 数据 ， 如 果 需 要 返回 xml， 可 以 显示 指定 返回 的 格式 。 编 辑 
Application/Home/Controller/IndexController.class.php 的 index 方法 ， 代 码 如 下 : 





访问 http://localhost/chapter-4/home/index/index， 输 出 以 下 数据 : 





可 能 有 的 读者 会 有 疑问 ， 为 什么 会 有 “think” 呢 ? 其 实 是 因为 xml 规定 xml 文档 有 且 仅 有 
一 个 根 元 素 。 


人 .号 重 定 向 和 页 面 跳 转 


4.8.1 重 定向 
在 访问 受 保护 的 地 址 时 ， 需 要 检测 登录 ， 如 果 用 户 未 登录 则 直接 跳 转 登录 页 面 ， 此 时 需要 用 
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到 重 定向 。ThinkPHP 重 定向 的 方法 名 为 redirect， 该 方法 为 Cntroller 的 成 员 方法 ， 需 要 在 控制 器 
中 才能 调用 。 
编辑 Application/Home/Controller/IndexController.class.php， 代 码 如 下 : 





浏览 器 访问 http://localhost/chapter-4/home/index/index ， 会 发 现 浏览 器 自动 跳 转 到 
http://localhost/chapter-4/home/index/login 了 。 

redirect 的 第 一 个 参数 为 URL 地 址 表达 式 ， 第 二 个 参数 为 URL 变量 ， 第 三 个 参数 为 延迟 时 
间 ， 第 四 个 参数 为 提示 消息 。 

值得 注意 的 是 ，ThinkPHP 还 内 置 一 个 redirect 函数 ， 该 函数 接收 三 个 参数 ， 第 一 个 参数 为 
URL 地 址 ， 第 二 个 参数 为 延迟 时 间 ， 第 三 个 参数 为 消息 提示 。 与 控制 器 redirect 方法 的 区 别 是 ， 
redirect 函数 的 第 一 个 参数 是 一 个 独立 的 URL 地 址 ， 系 统 不 会 对 其 做 任何 处 理 ， 而 控制 器 的 
Tedirect 方法 第 一 个 参数 是 URL 地 址 表达 式 ，ThinkPHP 会 根据 URL_MODEL 生成 相应 的 
URL。 


4.8.2 页 面 跳 转 
在 开发 中 ， 经 常 遇 到 一 些 带 有 信息 提示 的 跳 转 页 面 ， 例 如 “充值 成 功 ，3 秒 后 返回 订单 页 ” 


控制 器 





这 种 需求 。ThinkPHP 内 置 success 和 error 方法 来 实现 页 面 跳 转 。 
编辑 Application/Home/ControllerIndexControllerclass.php， 代 码 如 下 : 





浏览 器 访问 http://localhost/chapter-4/Home/Index/buy， 可 以 得 到 如 图 4-1 所 示 结 果 。 


购买 成 功 ，1 秒 后 跳 转 首页 


页 面 自动 味 转 等 待 时 间 : 1 





图 4-1 
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success 和 error 方法 的 第 一 个 参数 表示 提示 信息 ， 第 二 个 参数 表示 跳 转 地 址 (建议 用 U 方法 
生成 ) ， 第 三 个 参数 是 跳 转 时 间 (单位 为 秒 ) ， 例 如 : 

$this->success(" 操 作成 功 ，3 秒 后 返回 首页 ",U(*index*),3); 

$this->error(“ 您 尚未 登录 ，1 秒 后 返回 登录 页 ",U(“User/login”),1); 

如 果 跳 转 地 址 为 室 ，success 默认 跳 转 $_SERVER["HTTP_REFERER"]，error 默认 跳 转 
javascript:history.back(-1);。 

success 的 默认 跳 转 延迟 时 间 为 1 秒 ，error 方法 为 3 秒 。 

和 redirect 方法 不 同 的 是 ，success 和 error 方法 都 可 以 使 用 模板 ， 而 redirect 方法 只 能 输出 字 
符 串 ，success 和 error 默认 的 模板 文件 地 址 为 THINK_PATH . 'Tpldispatch_jump.tpl，success 方 
法 可 以 配置 “TMPL ACTION _ SUCCESS ”改变 模板 地 址 ，eror 方法 可 以 配置 

“TMPL ACTION_ERROR ”改变 模板 地 址 。 





外 .OHTTP 请 求 方法 


很 多 情况 下 ， 需 要 判断 当前 HTTP 请 求 方法 是 否 为 GET、POST、PUT 或 DELETE， 以 此 对 
同一 个 URL 地 址 针对 不 同 的 请 求 方法 来 实现 不 同 的 响应 。ThinkPHP 内 置 了 一 些 常 量 用 来 判断 请 
求 方法 ， 如 表 4-1 所 示 。 


常量 名 称 型 备注 


[spuer | 
当前 请 求法 


编辑 Application/Home/Controller/IndexController.class.php 方法 ， 代 码 如 下 : 
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人 


打开 浏览 器 访问 http://localhost/chapter-4/Home/Index/login， 输 出 “当前 为 空 GET 请 求 方 
法 ， 需 要 显示 登录 页 面 ”。 

如 何 测试 POST 请 求 呢 ? 这 里 使 用 表单 来 进行 处 理 ， 在 chapter-4 的 根 目录 下 新 建 
post.html， 代 码 如 下 : 
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打开 浏览 器 访问 http://localhost/chapter-4/post.html， 点 击 “ 提 交 ” 按 钮 ， 输 出 “当前 为 POST 
请 求 方法 ， 需 要 处 理 登 录 逻 辑 ”， 如 此 便 实现 了 “相同 URL 根据 不 同 请 求 方法 实现 不 同 响应 ” 
的 功能 。 


4 .10 读 肥 输入 


在 实际 开发 过 程 中 ， 存 在 一 条 黄金 守则 “永远 不 要 相信 用 户 的 输入 ”， 需 要 经 常 读 取 系统 变 
量 或 者 用 户 提交 的 数据 ， 这 些 数据 是 不 受信 任 的 ， 很 容易 引起 安全 隐患 ， 如 果 利用 好 ThinkPHP 
提供 的 变量 输入 功能 ， 就 可 以 避免 这 种 问题 了 。 

传统 的 变量 读 取 方 式 : 


ThinkPHP 框架 中 使 用 “I” 函数 进行 变量 的 获取 和 过 滤 ， 函 数 定义 如 下 : 
I( 变 量 来 源 .变量 名 /修饰 符 ,[ 默 认 值 ][ 过 滤 方 法 ][ 额 外 数据 源 ]) 
变量 来 源 指 变量 的 来 源 数组 ， 如 来 源 于 $_GET、$_POST， 完 整 来 源 定义 如 表 4-2 所 示 。 





表 4-2 
来 源 说 明 
get $_GET 
Ppost $_POST 
param 自动 判断 $ GET、$_POST 和 $_PUT 
Tequest S$ REQUEST 
put $_PUT 
session $_SESSION 
cookie $_COOKIE 
serVver $_ SERVER 
globals $_GLOBALS 
path 获取 PATHINFO 模式 的 URL 参数 
data 获取 其 他 类 型 的 参数 ， 需 要 配合 额外 数据 源 











变量 来 源 不 区 分 大 小 写 ， 变 量 名 区 分 大 小 写 。 
以 POST 为 例 ， 说 明了 函数 的 使 用 : 


2. 过 滤 方 法 


I 函数 支持 获取 整个 变量 数组 ， 如 : ICpost 7) 等 效 于 $_POST。 
如 果 在 调用 I 函数 时 没有 指定 过 滤 方 法 ， 系 统 会 采用 配置 “DEFAULT_FILTER” 的 值 ( 默 
认为 htmlspecialchars〉 作 为 函数 进行 过 滤 ， 该 参数 支持 多 个 过 滤 函 数 ， 例 如 : 


I(“post.username”) 等 效 于 htmlspecialchars(strip_tags($_POST[‘usemame’]))， 请 注意 函数 调用 
顺序 。 
1 函数 的 第 三 个 参数 如 果 传 入 的 是 函数 名 ， 则 使 用 该 函数 对 变量 进行 操作 并 返回 操作 结果 
(如 果 变 量 是 数组 ， 则 使 用 array_map 进行 处 理 ) ， 耕 则 调用 PHP 内 置 的 filter_var 方法 进行 处 
理 ， 例 如 : I(postemail,”,FILTER VALIDATE_EMAIL) 等 效 于 filter_var($_POST[‘email*],FILTER_ 
VALIDATE_EMAIL)。 


3. 正则 过 滤 


如 果 正则 匹配 失败 ， 返 回 默认 值 。 


4 不 进行 任何 过 滤 


某 些 情况 下 ， 不 希望 开启 过 滤 功 能 ， 比 如 CMS 系统 中 的 文章 内 容 ， 该 内 容 由 富 文本 编辑 器 
生成 ， 带 有 HTML 标记 ， 如 果 不 做 任何 处 理 ， 该 值 会 被 ThinkPHP 进行 htmlspecialchars 处 理 。 
使 用 I('post.content',",false) 来 关闭 过 滤 方 法 处 理 。 


5. 变量 修饰 符 
在 需要 指定 变量 值 的 格式 时 ， 可 以 使 用 变量 修饰 符 ， 可 用 修饰 符 如 表 4-3 所 示 。 
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仿 . 1 1 空 操作 


当 ThinkPHP 找 不 到 请 求 的 操作 时 ， 会 执行 empty 方法 ， 利 用 该 机 制 ， 可 以 实现 错误 页 面 和 
一 些 URL 优化 。 

本 例 使 用 空 操作 来 实现 一 个 用 户 预 移 的 功能 ， 新 建 ApplicatiovHome/ControllevUserControllerclass.php， 
代码 如 下 : 








”CE 








浏览 器 访问 http://localhost/chapter-4/Home/User/zhangsan， 输 出 “name:zhangsan”。 
执行 流程 如 下 : 


(1) 准备 执行 Home/Controller/UserController.class.php 的 zhangsan 方法 ; 


(2) 对 应 zhangsan 方法 不 存在 ， 执 行 UserController.class.php 的 _empty 方法 ， 并 将 
zhangsan 作为 $name 传 入 ; 


(3) 调用 UserController 的 view 方法 ， 输 出 “name:zhangsan”。 


4 .12 空 近 制品 


当 ThinkPHP 查找 不 到 对 应 的 控制 器 文件 的 时 间 ， 会 尝试 请 求 空 控制 器 EmptyController， 与 
室 操 作 类 似 ， 也 可 以 用 该 机 制定 制 错 误 页 面 和 URL 优化。 
编辑 Application/Home/Controller/EmptyController.class.php， 代 码 如 下 : 
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浏览 器 访问 http://localhost/chapter-4/Home/zhangsan， 输 出 “name:Zhangsan”， 首 字母 自动 
大 写 了 ， 这 是 ThinkPHP 的 Controller 命名 规范 。 
注意 : CONTROLLER_NAME 是 ThinkPHP 内 置 常 量 ， 指 当前 请 求 的 控制 器 名 称 。 


4.13 小 结 


本 章 需 要 掌握 的 内 容 : 


伪 静 态 
URL 大 小 写 
URL 生成 

Ajax 返回 

重 定向 和 页 面 跳 转 
读 取 输 入 

HTTP 请 求 方法 


本 章 需 要 扩展 的 内 容 : 
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前 置 和 后 置 操作 
动作 参数 绑 定 
空 操作 
空 控制 器 


ThinkPHP 中 基础 模型 类 为 Think\Model 类 ， 该 类 完成 了 基本 的 CURD、ActiveRecord 
操作 。 


与 .1 准备 工作 


在 Web 目录 下 新 建 chapter-5 文件 夹 ， 新 建 入 口 文件 并 完成 初始 化 。 
编辑 Application/Common/Conf/config.php， 代 码 如 下 : 


请 根据 实际 情况 调整 参数 。 
在 本 地 数据 库 添加 think_inaction 库 ， 并 执行 以 下 SQL 建立 示例 数据 表 : 
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与 .2 模型 定义 


模型 类 不 是 必须 定义 的 ， 只 有 当 存 在 额外 的 逻辑 或 者 属性 时 才 需 要 定义 ， 一 般 情况 下 ， 使 用 
ThinkPHP 提供 的 Model 类 已 经 可 以 完成 大 部 分 需求 。 

ThinkPHP 约定 的 模型 命名 规则 是 去 除 表 前 级 的 数据 表 名 称 ， 使 用 首 字 母 大 写 的 驼峰 命名 
法 ， 然 后 加 上 Model， 例 如 (假设 表 前 级 为 think_) : 

@ ”数据 表 名 称 为 “think user”， 去 除 表 前 组 后 为 “user”， 首 字母 大 写 并 且 驼 峰 命 名 后 
“User”， 加 上 Model 后 “UserModel”， 所 以 “think_user” 对 应 的 模型 名 称 为 
“UserModel” 。 

@ 数据 表 名 称 为 “think_user money”， 去 除 表 前 缓 后 为 “user_ money”， 首 字母 大 写 并 
且 驼 峰 命 名 后 “UserMoney”， 加 上 Model 后 “UserMoneyModel”， 所 以 
“think_user_ money” 对 应 的 模型 名 称 为 “UserMoneyModel”。 


如 果 需 要 自 定义 模型 ， 继 承 Think/Model 即 可 。 


与 .二 模型 实例 化 


根据 不 同 的 模型 定义 ， 实 例 化 的 方法 也 不 同 ， 大 致 有 以 下 方法 : new 实例 化 、M 函数 实例 
化 、D 函数 实例 化 和 空 模型 实例 化 。 


5.3.1 new 实例 化 


模型 类 本 质 也 是 PHP 的 类 ， 所 以 可 以 直接 new 实例 化 。 
以 “think_user” 为 例 ， 可 以 使 用 以 下 代码 实例 化 : 


Model 类 的 构造 方法 有 三 个 参数 ， 去 除 表 前 级 的 数据 表 名 称 ， 表 前 级 ， 连 接 配置 。 如 果 数 据 
表 没 有 表 前 级 ， 传 入 “null” 即 可 ， 连 接 配 置 格式 如 下 : 
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5.3.2”M 函数 实例 化 


M 函数 是 ThinkPHP 内 置 的 快捷 函数 ， 该 方法 接收 的 参数 与 Model 类 的 构造 方法 相同 ， 返 回 
值 为 实例 化 后 的 模型 对 象 。 





5.3.3 D 函数 实例 化 

D 函数 是 ThinkPHP 内 置 的 快捷 函数 ， 与 M 函数 最 大 的 区 别 在 于 D 函数 可 以 自动 检测 模型 
类 ， 如 果 存 在 指定 模型 类 ， 则 实例 化 该 模型 类 ， 和 否则 实例 化 “ThinlAModel” 类 ， 而 M 函数 只 会 
实例 化 “ThinkAModel” 类 。 
5.3.4” 空 模型 实例 化 

如 果 只 需要 执行 SQL， 不 需要 其 他 操作 的 话 ， 可 以 实例 化 一 个 空 模型 类 ， 例 如 : 





与 .人 4， 连贯 操作 


说 到 ThinkPHP， 不 得 不 提 到 它 的 “连贯 操作 ”功能 ， 连 贯 操作 可 以 有 效 地 提高 代码 质量 以 
及 开发 效率 。 比 如 要 查询 User 模型 中 status 为 1 的 前 10 条 记录 ， 并 且 按照 时 间 倒序 排序 ， 只 需 
要 如 下 代码 即 可 。 


a | 
a 
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该 代码 的 where、order、limit 就 是 连贯 操作 方法 ， 查 看 这 些 方法 的 源 代 码 发 现 ， 他 们 在 方法 






































的 最 后 都 返回 了 当前 模型 ， 所 以 这 是 连贯 操作 的 核心 ， 由 于 select 最 终 返 回 的 是 数据 集 ， 所 以 不 
是 连贯 操作 方法 。 

连贯 操作 方法 是 没有 先后 顺序 的 。 

ThinkPHP 支持 的 连贯 操作 方法 如 表 5-1 所 示 。 

表 5-1 

操作 方法 说 明 参数 类 型 
where 查询 或 者 更 新 的 限定 条 件 字符 串 、 数 组 或 对 象 
table 要 操作 的 表 名 称 字符 串 、 数 组 
alias 数据 表 别名 字符 串 
data 插入 或 者 更 新 的 数据 对 象 对 象 或 数组 
field 字符 串 或 数组 
order 字符 中 或 数组 
limit 字符 申 或 数字 
page 字符 申 或 数字 
group 字符 
i 字符 申 
join 字符 中 或 数组 
i 字符 串 、 数 组 或 对 象 
distinct | 同 distinct | 布尔 值 
lock 布尔 值 
cache 多 个 参数 
relation 字符 帅 或 布尔 值 
result 字符 申 
validate 数组 
auto 数组 
filter 字符 串 
scope 字符 趾 或 数组 
bind 数据 绑 定 操作 数组 或 多 个 参数 
token 令 牌 验证 布尔 值 
comment SQL 注释 字符 串 
index 数据 集 的 强制 索引 字符 串 
strict 数据 入 库 的 严格 检测 布尔 什 
5.4.1 where 

Where 方法 支持 字符 串 、 数 组 和 对 象 ， 但 是 不 推荐 使 用 对 象 。 

1. 字符 串 条 件 

$user = M('User'); 


$data = $user->where('admin=1 and status=1')->select(); 
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如 果 需 要 使 用 变量 时 ， 请 使 用 如 下 代码 进行 查询 ， 可 有 效 防止 SQL 注入 攻击 : 





模糊 搜索 查询 : 





5.4.2 table 

如 果 按照 ThinkPHP 的 约定 命名 数据 表 、 生 成 模型 的 话 ， 系 统 会 自动 识别 模型 对 应 的 数据 
表 ，table 方法 似乎 没有 用 武之 地 。 实 际 上 ，table 方法 设计 的 初衷 是 为 了 支付 多 表 操 作 以 及 切换 
操作 的 数据 表 。 


5.4.3 alias 
alias 用 于 设置 当前 数据 表 的 别名 ， 便 于 使 用 其 他 的 连贯 操作 ， 例 如 join 方法 等 。 
有 如 下 代码 : 


以 上 代码 最 终生 成 的 SQL 如 下 : 
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5.4.4 data 
data 方法 用 来 设置 当前 模型 需要 操作 的 数据 。 
有 如 下 代码 : 





执行 结果 会 报错 ， 因 为 未 经 过 $model->create 方法 处 理 过 的 数据 ，ThinkPHP 不 能 直接 使 用 。 
所 以 以 上 代码 更 改 为 如 下 代码 即 可 : 





而 使 用 data 方法 的 话 就 没有 这 么 麻烦 ， 代 码 如 下 : 





5.4.5 field 
field 用 来 选择 需要 返回 的 字段 ， 减 少数 据 库 和 网 络 开销 。 
有 如 下 代码 : 


以 上 代码 生成 的 SQL 语句 如 下 : 


field 的 方法 和 SQL 语句 中 “SELECT (xxx) FROM” 中 “(xxx)” 语 法 是 一 致 的 ， 可 以 使 用 
SQL 函数 如 count， 可 以 设置 别名 title ast 等 。 
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1. 字段 排除 


如 果 需 要 获取 排除 数据 表 中 的 content 字段 之 外 的 所 有 字段 ， 可 以 使 用 field 方法 的 排除 功 
能 ， 代 码 如 下 : 


系统 在 生成 SQL 时 就 不 会 选择 content 字段 。 
如 果 需 要 排除 多 个 字段 ，field 也 可 以 实现 ， 代 码 如 下 : 


2. 安全 写 入 


field 在 写 入 的 时 候 也 起 到 安全 过 滤 的 作用 ， 比 如 编辑 用 户 时 我 只 允许 更 改 nickname 和 
password 两 个 字段 ， 不 管 前 端 提交 了 什么 字段 ， 都 只 有 这 两 个 字段 会 被 ThinkPHP 写 入 数据 库 ， 
代码 如 下 : 


请 注意 ;save 方法 返回 该 方法 影响 的 数据 条 数 ， 如 果 一 条 都 没 受 影响 ， 返 回 0; 如 果 SQL 
语句 执行 失败 ， 则 返回 false。 所 以 在 判断 save 方法 的 执行 结果 时 ， 请 使 用 “= 一” 判断， 不 要 
使 用 “! ”判断 。 





5.4.6 order 
order 方法 用 来 对 结果 集 进 行 排序 。 
比如 需要 查询 积分 最 多 的 5 个 用 户 按照 积分 高 低 排 序 ， 则 可 以 使 用 以 下 代码 : 


以 上 代码 最 终生 成 的 SQL 如 下 : 


order 也 支持 对 多 个 字段 排序 ， 代 码 如 下 


以 上 代码 最 终生 成 的 SQL 如 下 : 
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注意 : 如 果 字 段 名 和 数据 库 关键 字 有 冲突 ， 可 以 使 用 数组 方法 调用 order， 代 码 如 下 : 


以 上 代码 最 终生 成 的 SQL 如 下 : 


5.4.7 limit 
limit 方法 用 来 限制 返回 的 结果 集 数量 ， 在 分 页 查询 时 用 的 很 多 。 


1. 限制 结果 集 数 量 


以 上 代码 最 终生 成 的 SQL 如 下 : 


limit 方法 也 可 以 用 于 写 入 操作 ， 假 设 需 要 更 新 积分 大 于 100 的 最 多 3 个 用 户 等 级 为 A， 代 
码 如 下 : 


以 上 代码 最 终生 成 的 SQL 如 下 : 


2. 分 页 查询 
limit 最 常用 的 场合 就 是 分 页 查询 了 ， 代 码 如 下 : 


以 上 代码 最 终生 成 的 SQL 如 下 : 





5.4.8 page 

page 方法 是 ThinkPHP 特地 为 分 页 操作 声明 的 一 个 方法 。 

我 们 知道 ，limit 可 以 用 来 分 页 ， 但 是 如 果 需 要 精确 查询 指定 页 数 的 数据 ， 则 需要 先 计算 偏 
移 量 再 来 查询 数据 库 。 而 使 用 page 方法 就 方便 了 很 多 ， 代 码 如 下 : 





5.4.9 group 
group 方法 用 来 对 结果 集 进行 分 组 ， 通 常 集合 SQL 统计 函数 进行 操作 。 
比如 需要 获得 每 个 用 户 发 表 的 文章 总 数 就 可 以 使 用 group， 代 码 如 下 : 





以 上 代码 最 终生 成 的 SQL 如 下 : 


5.4.10 having 
having 方法 用 于 筛选 经 过 group 分 组 之 后 且 满 足 条 件 的 数据 集 。 
比如 需要 获得 发 表 文章 数量 大 于 3 的 用 户 列表 ， 代 码 如 下 : 


以 上 代码 最 终生 成 的 SQL 语句 如 下 : 


5.4.11 join 

join 用 来 进行 连 表 查 询 。 

join 有 以 下 类 型 : 

@ INNERJOIN: 左 表 和 右 表 都 存在 匹配 行 则 返回 该 行 ， 否 则 返回 空 。 

@ LEFTJOIN: 左 表 有 匹配 行 则 返回 该 行 ， 右 表 的 所 有 字段 也 返回 ， 但 是 如 果 右 表 值 为 空 
的 话 ， 右 表 所 有 字段 值 为 空 。 

@ RIGHT JOIN: 右 表 中 有 匹配 行 则 返回 该 行 ， 左 表 的 所 有 字段 也 返回 ， 但 是 如 果 左 表 值 
为 空 的 话 ， 左 表 所 有 字段 值 为 空 。 
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@ FULLJOIN: 只 要 有 一 个 表 中 存在 匹配 ， 则 返回 该 行 。 
比如 需要 查询 id 为 1 的 文章 以 及 作者 ， 代 码 如 下 : 


以 上 代码 最 终生 成 的 SQL 如 下 : 


如 果 需 要 连接 多 个 表 ， 多 次 调用 join 即 可 。 


5.4.12 union 
union 用 于 合并 两 个 或 以 上 SELECT 语句 的 结果 集 。 
数据 量 很 大 的 时 候 往往 会 采取 分 表 策略 ， 如 think_user_1、think_user 2 等 。 
假设 需要 从 think_user_1 和 think_user 2 中 取得 name 字段 ， 代 码 如 下 : 





以 上 代码 最 终生 成 的 SQL 如 下 : 





5.4.13 distinct 
distinct 方法 用 于 返回 唯一 不 同 的 值 。 
假设 name 有 重 名 的 时 候 只 返回 不 重 名 的 记录 ， 代 码 如 下 : 


以 上 代码 最 终生 成 的 SQL 语句 为 : 


5.4.14 lock 
lock 方法 用 于 数据 库 锁 ， 在 进行 事务 处 理 的 时 候 会 用 到 。 
假设 一 个 商城 系统 有 一 个 good 表 ， 该 表 有 一 个 remain〈 库 存 ) 字段 ， 需 要 在 抢购 时 实时 更 





新 ， 此 时 就 需要 用 到 锁 来 保证 互 斥 操作 。 





以 上 代码 生成 的 关键 SQL 如 下 : 


“FOR UPDATE” 由 ThinkPHP 自动 加 上 ， 用 来 保证 互 斥 写 入 。 


5.4.15 cache 

cache 用 来 从 缓存 中 读 取 数 据 ， 使 用 cache 方法 后 ， 在 缓存 有 效 期 内 不 会 从 数据 库 查 询 ， 而 
是 直接 返回 缓存 中 的 数据 。 缓 存 的 详细 设置 ， 在 以 后 的 章节 会 提 到 。 

假设 需要 查询 id 为 5 的 用 户 数据 ， 且 缓存 ， 代 码 如 下 : 


以 上 代码 执行 流程 如 下 : 


(1) ThinkPHP 从 缓存 查询 有 无 数据 ， 如 果 有 ， 直 接 返 回 该 数据 ， 否 则 继续 执行 。 
(2) 根据 条 件 查询 数据 库 。 
(3) 将 第 2 步 的 结果 写 入 缓存 并 返回 。 


默认 情况 下 ， 缓存 有 效 期 和 缓存 类 型 是 由 DATA_CACHE_TIME 和 DATA_CACHE TYPE 
配置 参数 决定 的 ， 但 cache 方法 可 以 单独 指定 ， 代 码 如 下 : 


以 上 代码 表示 对 结果 集 使 用 xcache 缓存 ， 有 效 期 为 60 秒 。 


5.4.16 fetchSql 
fetchSql 方法 直接 返回 生成 的 SQL 而 不 是 数据 ， 也 不 执行 数据 库 查 询 。 
有 如 下 代码 : 


以 上 代码 会 输出 “SELECT * FROM think_user LIMIT 1”。 
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5.4.17 strict 
strict 用 于 设置 数据 写 入 和 查询 是 否 严格 检查 ， 是 否 存在 字段 。 默 认 情况 下 不 合法 数据 字段 
自动 删除 ， 如 果 设 置 了 严格 检查 ， 则 会 抛 出 异常 。 代码 如 下 : 


如 果 $data 中 键 名 在 数据 库 中 没有 对 应 的 字段 ，ThinkPHP 会 抛 出 异常 。 


5.4.18 index 
index 方法 用 于 设置 查询 的 强制 索引 ， 代 码 如 下 : 


注意 : username 为 索引 名 称 ， 不 是 字段 名 。 


局. 与 cuRD 操作 


谈 到 数据 库 操 作 不 得 不 说 下 经 典 的 “CURD 操作 ”， 这 是 任何 一 个 涉及 数据 库 操 作 的 框架 
需要 面 对 的 问题 。 

何谓 CURD? 

@ C: create， 插入 数据 。 

@ U: update， 更 新 数据 。 

@ R: read， 读 取 数 据 。 

@ DD: delete， 删 除数 据 。 


对 于 数据 库 的 操作 主要 是 以 上 几 种 操作 。 


5.5.1 创建 数据 


ThinkPHP 可 以 快速 地 创建 数据 对 象 ， 最 典型 的 场景 是 自动 根据 表单 POST 数据 创建 数据 对 
象 。 
代码 如 下 : 


create 方法 也 支持 从 数组 创建 数据 对 象 ， 代 码 如 下 : 








create 方法 的 第 二 个 参数 用 来 指明 当前 操作 类 型 为 插入 或 者 更 新 操作 。 默 认 情 况 下 ， 如 果 提 
交 的 数据 对 象 中 有 主键 ，ThinkPHP 则 认为 当前 操作 为 更 新 操作 。 
操作 类 型 由 ThinkPHP 的 Model 常量 指定 : 


@ Model::MODEL INSERT 为 1， 插 入 操作 。 
@ Model::MODEL _ UPDATE 为 2， 更 新 操作 。 


注意 : create 操作 产生 的 数据 并 没有 真正 写 入 数据 库 ， 而 是 在 调用 add 或 者 save 方法 之 后 才 
会 操作 数据 库 。 


5.5.2 插入 数据 
ThinkPHP 插入 数据 使 用 add 方法 ， 代 码 如 下 : 





5.5.3” 读 取 数 据 
ThinkPHP 可 以 读 取 字段 值 、 单 条 数据 、 数 据 集 。 
1. 读 取 字段 值 
使 用 getField 方法 ， 假 设 需 要 获得 id 为 3 的 用 户 的 积分 ， 代 码 如 下 : 


如 果 需 要 返回 整 列 数据 ， 而 不 是 第 一 列 的 数据 ， 代 码 如 下 : 
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返回 的 结果 类 似 于 array(1,2,3,5,6)。 


2. 读 取 单条 数据 


使 用 find 方法 ， 如 果 传 入 参数 ，ThinkPHP 会 根据 主键 匹配 传 入 的 值 。 
假设 需要 查询 id 为 1 的 用 户 数据 ， 代 码 如 下 : 


衣 式 二 


使 用 select 方法 ， 用 来 返回 匹配 的 数据 行 。 
假设 需要 查询 积分 大 于 100 的 所 有 用 户 ， 代 码 如 下 : 


5.5.4 ”更 新 数据 
ThinkPHP 的 数据 更 新 包括 更 新 记录 和 更 新 字段。 
1. 更 新 记录 
使 用 save 方法 ， 代 码 如 下 : 





注意 : 


@ ”为 了 保证 数据 库 的 安全 ， 避 免 出 错 ， 更 新 整个 数据 表 ， 如 果 没 有 任何 更 新 条 件 ， 数 据 
对 象 本 身 也 不 包含 主键 字段 的 话 ，save 方法 不 会 更 新 任何 数据 库 的 记录 。 
@ save 方法 返回 受 影响 的 行 数 ， 如 果 为 0 则 没有 更 新 一 条 记录 ， 如 果 为 false 则 证 明 执行 


0 | ”CEEFEEE 
过 程 中 出 错 ， 所 以 在 判断 执行 结果 时 请 使 用 “一 -” 判 断 是 否 为 false。 
2. 更 新 字段 


更 新 字段 使 用 setField 方法 ， 参 数 为 〈 字 段 名 ， 字 段 值 ) 。 
假设 需要 更 新 id 为 1 的 用 户 score 为 100， 代 码 如 下 : 








如 果 需 要 更 新 统计 字段 ， 如 积分 减 100、 点 击 数 加 1， 可 以 使 用 ThinkPHP 提供 的 setDec 和 
setInc 方法 ， 举 例如 下 。 
id 为 1 的 用 户 积分 减 100， 代 码 如 下 : 


id 为 1 的 文章 点 击 数 加 1， 代 码 如 下 : 


5.5.5 ”删除 数据 


使 用 delete 方法 。 
假设 需要 删除 id 为 1 的 文章 (id 为 主键 ) ， 代 码 如 下 : 


delete 方法 返回 值 同 save 方法 。 

为 了 避免 错 删 数据 ， 如 果 没 有 传 入 任何 条 件 进行 删除 操作 的 话 ， 不 会 执行 删除 操作 。 
delete 方法 支持 order 和 limit 操作 。 

假设 需要 删除 score 排名 前 5 的 用 户 数据 ， 代 码 如 下 : 
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与 .查询 语 言 


5.6.1 查询 方式 
ThinkPHP 支持 字符 串 查询 、 数 组 查询 、 对 象 查询 三 种 查询 方法 ， 笔 者 常用 数组 查询 方式 。 


1. 字符 串 查询 方式 


这 是 最 传统 的 方式 ， 但 是 有 SQL 注入 风险 ， 不 推荐 使 用 。 
假设 需要 查询 id 为 1 的 用 户 数据 ， 代 码 如 下 : 


2. 数组 查询 方式 
假设 需要 查询 id 为 1 的 用 户 数据 ， 代 码 如 下 : 





3. 对 象 查 旬 方式 
本 文 以 stdClass 为 例 查询 id 为 1 的 用 户 数据 ， 代 码 如 下 : 












性 在 使 用 数组 和 对 象 方式 查询 的 时 候 ， 如 果 传 入 了 不 存在 的 查询 字段 是 会 被 自动 过 滤 的 。 


5.6.2 ”表达 式 查询 


ThinkPHP 使 用 表达 式 查询 可 以 支持 更 多 的 SQL 查询 语法 ， 如 大 于 、 小 于 等 ， 查 询 表达 式 使 
用 的 一 般 形式 为 : 





表达 式 不 分 大 小 写 ， 支 持 的 表达 式 查询 如 表 5-2 所 示 。 














表达 式 查 询 用 法 如 下 : 
1.EQ 


8.BETWEEN 
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9.NOT BETWEEN 


10.IN 


11. NOTIN 


12.EXP 


5.6.3 ”快捷 查询 


快捷 查询 可 以 进一步 简化 查询 条 件 的 写法 ， 用 “|” 表 示 “OR ”查询 ， 用 “人 ”表示 
“AND” 查 询 。 


1. 不 同 字段 相同 查询 条 件 的 查询 
假设 需要 根据 手机 号 码 或 者 姓名 搜索 用 户 ， 代 码 如 下 : 


以 上 代码 最 终生 成 的 SQL 如 下 : 





2. 不 同 字段 不 同 查询 条 件 的 查询 
假设 需要 查询 手机 号 码 为 “13666666666” 且 姓名 为 “zhangsan” 的 用 户 数据 ， 代 码 如 下 : 





以 上 代码 最 终生 成 的 SQL 如 下 : 
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前 
训 


“=-” 右 边 的 值 与 左边 的 字段 按 顺序 对 应 。 
“_multi” 必须 放 在 数组 最 后 。 


5.6.4 ”区 间 查 询 


结果 表达 式 查 询 可 以 在 一 定 区 间 内 查询 数据 。 
假设 需要 获取 积分 大 于 100 且 小 于 等 于 200 的 用 户 ， 代 码 如 下 : 


生成 的 查询 条 件 为 : 


如 果 需 要 为 “OR” 查 询 ， 代 码 如 下 : 


生成 的 代码 如 下 : 


5.6.5 ”统计 查询 


count、max、min、avg、sum 等 SQL 统计 函数 在 ThinkPHP 中 有 对 应 的 快捷 函数 。 
用 法 如 下 : 

1. count 

获取 记录 条 数 : 


或 者 根据 字段 统计 ， 代 码 如 下 : 


2. max 


获取 最 大 值 : 


3. min 


获取 最 小 值 : 
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4.avg 
获取 平均 值 : 


5. sum 


获取 算术 和 : 


6. SQL 查 稀 


虽然 ThinkPHP 内 署 的 操作 已 经 可 以 实现 绝 大 部 分 需求 ， 但 是 特殊 情况 下 需要 执行 原始 的 
SQL 查询 时 ， 这 些 方法 就 不 够 用 了 ， 以 下 两 个 方法 使 用 原始 的 Db 类 进行 操作 ， 不 做 其 他 处 理 。 


@@ query 方法 


执行 读 取 操作 ， 如 果 成 功 返 回 数据 集 〈 同 select) ， 失 败 返回 false。 
读 取 id 为 1 的 用 户 数据 ， 代 码 如 下 : 


@ execute 方 法 


执行 写 入 操作 (包括 INSERT INTO、UPDATE、DELETE) ， 执 行 成 功 返回 受 影响 的 行 数 ， 
失败 则 返回 false。 
更 新 id 为 1 的 用 户 nickname 为 “hehe”， 代 码 如 下 : 


与 .7 自动 验证 


自动 验证 是 ThinkPHP 模型 层 提 供 的 一 种 数据 验证 方法 ， 可 以 在 使 用 create 创建 数据 对 象 的 
数据 验证 有 两 种 方式 : 

@ ”静态 方式 .在 模型 类 中 通过 $_validate 定义 。 

@ “动态 方式 : 使 用 模型 类 的 validate 方法 。 


1. 验证 规则 
验证 规则 如 下 : 


array( 
array (字段 名 ， 验 证 规则 ， 错 误 提示 ， [验证 条 件 ， 附 加 规则 ， 验 证 场景 ] ) 
); 


@ 字段 名 : 需要 验证 的 表单 字段 名 称 ， 这 个 字段 不 一 定 是 数据 库 字段 ， 也 可 以 是 表单 的 


一 些 辅助 字段 ， 例 如 确认 密码 和 验证 码 等 。 在 个 别 验证 规则 和 字段 无 关 的 情况 下 ， 


验 


证 字段 是 可 以 随意 设置 的 ， 例 如 expire 有 效 期 规则 是 和 表单 字段 无 关 的 。 如 果 定 义 了 


字段 映射 的 话 ， 这 里 的 验证 字段 名 称 应 该 是 实际 的 数据 表 字 段 而 不 是 表单 字段 。 


@ ”验证 规则 : 要 进行 验证 的 规则 ， 需 要 结合 附加 规则 ， 如 果 在 使 用 正则 验证 的 附加 规则 
情况 下 ， 系 统 还 内 置 了 一 些 常用 正则 验证 的 规则 ， 可 以 直接 作为 验证 规则 使 用 ， 包 括 : 


require (必须 ) 、email (邮箱 ) 、url (URL 地 址 ) 、currency (货币 ) 、number (数字 ) 。 
@ ”错误 提示 : 用 于 验证 失败 后 的 提示 信息 定义 。 
@ 验证 条 件 : 可 选 ， 如 表 5-3 所 示 。 


表 5-3 


说 明 


存在 字段 就 验证 默认) 
[zm 


self:MUST_ VALIDATE 或 者 1 必须 验证 





值 不 为 空 的 时 候 验 证 


@ ”附加 规则 : 可 选 ， 如 表 5-4 所 示 。 










g 正则 验证 ， 定 义 的 验证 规则 是 一 个 正则 表达 式 〈 默 认 ) 
function 函数 验证 ， 定 义 的 验证 规则 是 一 个 函数 名 (系统 内 置 或 自 定义 函数 ) 






















callback 回调 验证 ， 定 义 的 验证 规则 是 当前 模型 类 的 成 员 方 法 
confirm 验证 两 个 字段 是 否 相同 ， 验 证 规则 为 字段 

[equal 相等 验证 ， 验 证 规则 为 需要 匹配 的 值 

noteegual 不 等 验证 ， 验 证 规则 为 需要 匹配 的 值 
in 验证 在 一 个 集合 内 ， 验 证 规则 为 数组 或 运 号 分 陋 的 字符 种 





验证 不 在 一 个 集合 内 ， 验 证 规则 同 in 














length 长 度 验证 ， 验 证 规则 为 数字 或 者 字符 串 ， 如 长 度 范围 “1,10” 
between 验证 在 某 个 范围 ， 验 证 规则 为 数组 或 字符 串 ， 如 [1,10] 或 “1,10” 
notbewteen 验证 不 在 某 范围 ， 验 证 规则 同 between 























expire 验证 是 否 在 有 效 期 ， 验 证 规则 表示 时 间 范围 ， 可 以 使 用 时 间 字 符 串 或 时 间 戳 

ip allow 验证 ip 是 否 允许 ， 验 证 规则 表示 允许 的 地 址 列表 ， 如 “192.168.1.1,192.168.1.254” 
ip deny 验证 ip 是 否 禁 止 ， 验 证 规则 同 ip_allow 

unique 字段 唯一 








@。 验证 场景 : 可 选 ， 如 表 5-5 所 示 。 
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场景 说 明 

新 增 数据 时 验证 

编辑 数据 时 验证 

全 部 情况 下 验证 默认 ) 
可 以 根据 实际 需求 自 定义 验证 场景 。 
2. 代码 测试 


新 建 Application/Home/Model/UserModel.class.php， 代 码 如 下 : 
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接 下 来 对 所 定义 的 验证 规则 一 条 一 条 进行 测试 。 
人 XI) 编辑 Application/Home/Controller/IndexController.class.php 的 index 方法 ， 代 码 如 下 : 





打开 浏览 器 访问 http://localhost/think-inaction/chapter-5/index.php， 可 以 发 现 页 面 输出 “非法 
数据 对 象 ”， 因 为 ThinkPHP 会 对 提交 的 数据 进行 CSRF 〈 跨 站 请 求 伪造 ) 检测 ， 只 有 本 站 表单 
提交 的 数据 ，ThinkPHP 才 会 认为 是 合法 数据 。 这 里 为 了 自动 验证 ， 就 不 处 理 该 操作 ， 直 接 对 数 
据 进行 处 理 。 


人 62 编辑 该 文件 的 index 方法 ， 代 码 如 下 : 
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刷新 浏览 器 ， 可 以 看 到 输出 了 “密码 不 能 为 室 ”， 证 明 第 2 条 验证 规则 生效 。 
在 数据 库 中 插入 一 条 记录 ， 如 表 5-6 所 示 。 





继续 编辑 index 方法 ， 代 码 如 下 : 





刷新 浏览 器 ， 可 以 看 到 输出 了 “用 户 名 已 存在 ”， 证 明 第 3 条 验证 规则 生效 。 
JT04 继续 编辑 index 方法 ， 代 码 如 下 : 











刷新 浏览 器 ， 可 以 看 到 输出 了 “密码 长 度 必须 在 6-20”， 证 明 第 4 条 验证 规则 生效 。 
E05 继续 编辑 index 方法 ， 代 码 如 下 : 





刷新 浏览 器 ， 可 以 看 到 输出 了 “密码 格式 错误 ”， 证 明 第 5 条 验证 规则 生效 。 
CT06。 继续 编辑 index 方法 ， 代 码 如 下 : 





刷新 浏览 器 ， 可 以 看 到 输出 了 “确认 密码 错误 ”， 证 明 第 6 条 验证 规则 生效 。 第 6 条 规则 的 
意义 是 存在 password 字段 且 当 前 场景 为 插入 数据 库 时 生效 。 由 于 $data 中 不 包含 主键 ，ThinkPHP 
自动 判断 当前 场景 为 插入 模式 ， 所 以 第 6 条 规则 生效 。 解 决 办 法 是 将 $data 改 为 如 下 结构 : 





a 


此 时 刷新 浏览 器 ， 可 以 看 到 输出 了 “ok”。 
GT07 第 7 条 验证 规则 使 用 了 回调 方法 进行 验证 ， 该 方法 为 当前 模型 成 员 方 法 ， 返 回 true 为 
通过 验证 ， 返 回 false 为 验证 不 通过 。 继 续 编辑 index 方法 ， 代 码 如 下 : 





刷新 浏览 器 ， 可 以 看 到 输出 了 “用 户 名 非法 ”， 证 明 第 7 条 验证 规则 生效 。 


5.8 自动 完成 


自动 完成 是 ThinkPHP 提供 用 来 完成 数据 自动 处 理 和 过 滤 的 方法 ， 使 用 create 方法 创建 数据 
对 象 的 时 候 会 自动 完成 数据 处 理 。 

因此 ， 在 ThinkPHP 使 用 create 方法 来 创建 数据 对 象 是 更 加 安全 的 方式 ， 而 不 是 直接 通过 
add 或 者 save 方法 实现 数据 写 入 。 

自动 完成 通常 用 来 完成 默认 字段 写 入 、 安 全 字段 过 滤 以 及 业务 逻辑 的 自动 处 理 等 ， 和 自动 验 
证 的 定义 方式 类 似 ， 自 动 完成 的 定义 也 支持 静态 定义 和 动态 定义 两 种 方式 。 


@ 静态 方式 : 在 模型 类 里 面 通过 $_auto 属性 定义 处 理 规则 。 
@ ”动态 方式 .使 用 模型 类 的 auto 方法 动态 创建 自动 处 理 规则 。 
1. 定义 规则 

两 种 方式 的 定义 规则 是 一 致 的 ， 一 般 格式 为 : 
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@ 完成 字段 : 需要 自动 完成 的 字段 名 。 
@ 完成 规则 : 以 何 种 规则 处 理 该 字段 。 
@ 完成 条 件 : 可 选 ， 自 动 完成 的 执行 场景 ， 场 景 如 表 5-7 所 示 。 


表 5-7 
场景 说 明 


新 增 数据 的 时 候 处 理 默认》 


编辑 数据 的 时 候 处 理 
所 有 情况 都 处 理 


@。 附加 规则 : 可 选 ， 如 表 5-8 所 示 。 





说 阴 
8 


2. 代码 测试 
请 在 数据 库 执行 以 下 SQL 更 改 c5_user 的 表 结构 : 








编辑 Application/Home/Model/UserModel.class.php， 代 码 如 下 : 
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可 以 看 到 $_auto 数组 下 定义 了 3 条 自动 完成 规则 ， 解 读 如 下 : 
@ ”新 增 或 编辑 的 时 候 对 密码 进行 md5 函数 加 密 处 理 。 

@ ”新 增 的 时 候 将 created at 设置 为 当前 时 间 戳 。 

@ ”编辑 的 时 候 将 updated_at 设置 为 当前 时 间 玲 。 








编辑 Application/Home/Controller/IndexController.class.php 的 index 方法 ， 代 码 如 下 : 





打开 浏览 器 访问 http://localhost/thinkphp-inaction/chapter-5/index.php?s=/home/index/index， 可 
以 看 到 浏览 器 输出 了 如 下 数据 : 





可 以 看 到 规则 1 和 规则 2 已 经 成 功 运行 了 。 
编辑 Application/Home/ControllerIndexControllerclassphp ， 新 增 “update” 方 法 ， 代 码 如 


下 : 
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画 “6” 是 index 方法 中 返回 的 用 户 ID， 请 读者 根据 实际 情况 进行 处 理 。 


打开 浏览 器 访问 http://localhost/thinkphp-inaction/chapter-5/index.php?s= /home/index/update， 
可 以 看 到 浏览 器 输出 了 如 下 数据 : 





可 以 发 现 规则 1 和 规则 3 成 功 运行 了 。 


与 . 咏 视图 模型 

视图 一 般 指数 据 库 的 视图 ， 视 图 是 一 个 虚拟 表 ， 也 拥有 列 和 数据 。 但 是 ， 视 图 并 不 在 数据 库 
中 以 存储 的 数据 值 集 形式 存在 。 视 图 模型 常用 来 解决 HAS_ONE 和 BELONGS_TO 类 型 的 关联 
查询 。 
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要 定义 视图 模型 ， 需 要 继承 \Think\Model\ViewModel， 然 后 配置 $viewFields 属性 。 
在 数据 库 执行 以 下 SQL: 





“c5_post” 表 的 “user id” 关联 于 “c5_user” 的 “id” 字 段 ， 用 来 标识 文章 的 发 布 者 。 
继续 执行 以 下 SQL 向 “c5_post” 表 插入 测试 数据 : 


最 后 的 6 为 用 户 ID， 请 读者 去 查询 “c5_user” 表 中 的 数据 ， 将 user_id 蔡 换 。 


1. 视图 定义 
在 Application/Home/Model 下 新 建 PostViewModel.class.php， 代 码 如 下 : 





代码 说 明 : 
因为 定义 的 是 视图 模型 ， 所 以 需要 继承 ViewModel，$viewFields 为 数组 ， 数 组 的 键 名 为 原 
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始 表 模型 ， 本 例 中 需要 将 文章 的 作者 一 并 查询 出 来 ， 所 以 可 以 判定 需要 从 “文章 ”、“ 用 户 ” 两 
个 表 读 取 数据 。 

数组 的 值 为 数据 表 的 键 名 映射 以 及 关联 字段 定义 ， 由 于 “c5_user” 表 中 的 “usemame” 是 我 
们 需要 的 数据 ， 但 是 字段 名 比较 敏感 ， 这 里 将 “username” 了 映射 为 “author” 字 段 ，“ on” 需要 
放 在 数组 的 最 后 ， 定 义 关联 字段 。 


2. 视图 查询 


视图 模型 查询 和 普通 模型 查询 本 质 是 一 致 的 ， 编 辑 Application/Home/IndexController. 
class.php， 新 增 “posts” 方 法 ， 代 码 如 下 : 





打开 浏览 器 ， 访 问 http://localhost/thinkphp-inaction/chapter-5/index.php?s=/home/index/posts， 
可 以 看 到 浏览 器 输出 了 如 下 数据 : 





可 以 看 到 结果 中 有 “author” 字 段 。 
其 他 查询 同 本 章 5.6 节 。 





5.10 关联 机 时 


视图 模型 可 以 解决 大 部 分 需求 ， 但 是 对 于 诸如 HAS_MANY 之 类 的 关系 ， 用 视图 模型 是 不 
合适 的 ， 所 以 需要 使 用 关联 模型 。 
关联 关系 包括 一 对 一 、 一 对 多 、 多 对 多 三 种 ， 用 程序 的 方式 定义 如 下 : 


要 执行 关联 查询 ， 模 型 类 需要 继承 \Think\Model\RelationModel， 并 配置 $_link 属性 。 
下 面 实现 各 个 关联 关系 的 定义 方式 。 


5.10.1 HAS_ONE 


HAS_ONE 表示 当前 模型 有 且 仅 有 一 个 子 对 象 ， 比如 每 个 用 户 有 一 个 详细 资料 ， 在 数据 库 
执行 以 下 SQL: 





编辑 Application/Home/Model/UserModel.class.php， 代 码 如 下 : 
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需要 注意 的 是 $_link 配置 : 











上 面 代码 中 各 个 参数 的 设置 说 明 如 下 : 


@ “extra”: 关联 名 称 ， 即 最 终 查 询 出 来 的 关联 数据 键 名 ; 
@ “mapping type”: 关联 类 型 ， 每 个 用 户 有 一 个 详细 资料 数据 ， 所 以 关系 为 
HAS_ONE; 
@ “foreign_ key”: 外 建 名 ， 本 例 中 使 用 “c5_user extra” 的 “user id” 字段 去 关联 
“C5_user” 的 主键 字段 。 
@ “mapping fields”: 需要 查询 的 关联 字段 名 称 ， 本 例 只 需要 邮箱 和 QQ 即 可 。 


编辑 Application/Home/Controller/IndexController.class.php， 新 增 “posts2” 方 法 ， 代 码 
如 下 : 





只 有 显示 调用 “relation” 方 法 ThinkPHP 才 会 进行 关联 查询 。 
打开 浏览 器 访问 http://localhost/thinkphp-inaction/chapter-5/index.php?s=/home/index/posts2， 可 
以 看 到 浏览 器 输出 了 如 下 数据 : 
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5.10.2 BELONGS_TO 


BELONGS_TO 表示 当前 模型 从 属于 另外 一 个 模型 ， 比 如 ， 每 篇 文章 都 从 属于 一 个 用 户 ， 我 
们 可 以 做 如 下 关联 定义 : 
在 Application/Home/Model 下 新 建 PostModel.class.php， 代 码 如 下 : 





编辑 Application/Home/Controller/IndexController.class.php， 新 增 “posts3” 方 法 ， 代 码 


如 下 : 
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打开 浏览 器 访问 http://localhost/thinkphp-inaction/chapter-5/index.php?s=/home/index/posts3， 可 
以 看 到 浏览 器 输出 了 如 下 数据 : 





5.10.3 HAS_MANY 


HAS_MANY 表示 当前 模型 拥有 多 个 子 对 象 ， 比 如 每 个 用 户 可 以 有 多 篇 文章 ， 可 以 定义 如 下 
关联 模型 ， 编 辑 Application/Home/Model/UserModel.class.php 的 “$_link” 属 性 ， 代 码 如 下 : 
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编辑 Application/Home/Controller/IndexController.class.php， 新 增 “posts4” 方 法 ， 代 码 
如 下 : 





打开 浏览 器 访问 http://localhost/thinkphp-inaction/chapter-5/index.php?s=/home/index/posts4， 可 
以 看 到 浏览 器 输出 了 如 下 数据 : 





5.10.4 MANY_TO MANY 
MANY_TO_MANY 为 多 对 多 关联 ， 以 本 文 目前 的 深度 来 说 ， 为 了 避免 读者 混淆 ， 和 暂 不 介 
绍 ， 有 需要 的 读者 可 以 上 网 自行 查询 资料 。 


5.11 小 结 


本 章 需 要 掌握 的 内 容 : 
@ ”模型 CURD 操作 
复杂 查询 操作 
自动 验证 

自动 完成 

视图 模型 

本 章 需 要 扩展 的 内 容 : 


@ ”关联 模型 
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本 章 所 提 到 的 “模板 ”和 “视图 ”为 同一 概念 。 


各. 1 模板 定义 


每 个 模块 的 模板 文件 是 独立 的 ， 默 认 的 模板 文件 定义 规则 是 : 


默认 的 视图 目录 是 模块 的 View 目录 ， 框 架 默 认 的 视图 后 级 为 “.html”， 系 统 默 认 不 启用 模 
板 主题 功能 。 
按照 该 规则 ， 可 以 推断 Home 模块 下 User 控制 器 add 方法 对 应 的 模板 文件 路 径 应 为 : 


如 果 项 目的 视图 目录 不 是 View， 可 以 通过 以 下 配置 更 改 目录 : 


模板 目录 就 成 了 Application/Home/Template 了 。 
如 果 需 要 更 改 模板 文件 的 后 级 ， 可 以 通过 配置 “TMPL_TEMPLATE_SUFFIX”， 例 如 : 


模板 文件 的 后 级 就 成 了 “.tpl”。 


.2 模板 主题 


如 果 某 个 模块 需要 支持 多 个 主题 的 话 ， 可 以 使 用 模板 主题 功能 。 配 置 
“DEFAULT_THEME” 即 可 。 例 如 : 


启用 模块 主题 之 后 ， 模 板 文件 的 目录 为 : 


如 果 需 要 动态 改变 模板 主题 ， 可 以 在 视图 泻 染 之 前 ， 调 用 以 下 方法 : 


.了 模板 赋值 


如 果 要 在 模板 中 输出 变量 ， 必 须 在 控制 器 中 把 变量 传递 给 模板 ， 系 统 提供 了 assign 方法 对 模 
板 变量 赋值 ， 无 论 何 种 变量 类 型 都 统一 使 用 assign 赋值 。 


注意 : ThinkPHP 还 有 一 个 赋值 语法 ， 代 码 如 下 : 





该 语法 在 控制 器 有 继承 的 时 候 会 出 现 问题 ， 不 建议 使 用 。 
如 果 需 要 赋值 多 个 变量 ， 可 以 采用 数组 的 形式 进行 赋值 操作 : 





.A 模板 党 染 


模板 定义 后 就 可 以 泻 染 模板 和 输出， 系统 也 支持 直接 泻 染 内 容 输出 ， 模 板 赋值 必须 在 模板 泻 染 
之 前 操作 ， 泻 染 方法 名 为 “display”。 
方法 原型 如 下 : 


“模板 文件 路 径 ” 支 持 以 下 写法 : 
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@ 无 参数 : 系统 自动 定位 模板 文件 ， 默 认 情况 下 为 “模块 名 /View/ 控 制 器 名 称 / 方 法 名 
称 .html”。 


@ [模块 @][ 控 制 器 :][ 操 作 ]: 如 S$this->display("User:login”)， 系 统 将 定位 到 “模块 名 
/View/User/login.html” 。 
@ ”完整 模板 文件 路 径 。 


如 果 不 需 要 直接 输出 可 以 使 用 “fetch” 方 法 ， 该 方法 与 “display” 方 法 区 别 是 “display” 输 
出 模板 内 容 ，“fetch” 不 输出 。 可 以 利用 该 特性 进行 “页 面 缓存 ”功能 的 开发 。 


6.5 总 结 


本 章 需 要 掌握 的 内 容 : 


@ ”模板 定义 
@ ”模板 赋值 
@ ”模板 泻 染 


本 章 可 以 扩展 的 内 容 : 
@ ”利用 fetch 方法 开发 页 面 缓存 功能 
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本 章 讲述 如 何 利用 ThinkPHP 自 带 的 模板 引擎 来 定义 模板 文件 、 模 板 继承 、 模 板 语言 等 内 


ThinkPHP 内 置 一 个 基于 XML 的 模板 引擎 “ThinkTemplate”， 该 引擎 有 如 下 特点 : 


支持 XML 标签 库 和 普通 标签 的 混合 定义 ; 
支持 直接 使 用 PHP 代码 书写 ; 

支持 文件 包含 ; 

支持 多 级 标签 谋 套 ; 

支持 布局 模板 功能 ; 

一 次 编译 多 次 运行 ， 编 译 和 运行 效率 非常 高 ; 
模板 文件 和 布局 模板 更 新 ， 自 动 更 新 模板 缓存 ; 
系统 变量 无 须 赋值 直接 输出 ; 

支持 多 维 数组 的 快速 输出 ; 

支持 模板 变量 的 默认 值 ; 

支持 页 面 代码 去 除 HTML 空白 ; 

支持 变量 组 合 调节 器 和 格式 化 功能 ; 

允许 定义 模板 禁用 函数 和 禁用 PHP 语法 ; 
通过 标签 库 方式 扩展 。 


了 .1 变量 输出 


7.1.1 输出 形式 

在 模板 中 输出 变量 语法 为 “{$val}”，“val” 为 变量 名 称 ，“{}” 为 ThinkPHP 模板 引擎 定 
界 符 ， 默 认为 “f}7”， 可 以 通过 设置 “TMPL L DELIM” 和 “TMPL _R_DELIM” 来 进行 更 
改 ， 如 在 配置 文件 中 定义 : 
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那么 输出 “val” 变 量 的 语法 为 “{<$val>}”。 
如 果 需 要 输出 数组 变量 ， 有 以 下 写法 。 
假设 需要 输出 示例 数组 中 的 “name”， 示 例如 下 : 





如 果 需 要 输出 多 维 数组 ， 示 例如 下 : 





输出 “admin” 语 法 如 下 : 





输出 “admin2” 语 法 如 下 : 
(SaatalllImanel 
如 果 需 要 输出 对 象 ， 可 以 使 用 “->” 操 作 符 ， 如 : 


7.1.2 测试 


新 建 “chapter-7” 项 目 ， 编 辑 Application/Home/Controller/IndexController.class.php 的 index 
方法 ， 代 码 如 下 : 


【e2] 
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从 代码 最 后 的 “ Sthis->display0) ”可 以 得 知 模 板 文 件 路 径 为 
“Application/Home/View/Index/index.html”， 编 辑 该 文件 ， 内 容 如 下 : 





了 .2 系统 变量 


7.2.1 语法 形式 


一 个 成 熟 的 框架 会 定义 常用 变量 为 系统 变量 ， 这 些 变量 不 需要 使 用 者 预先 声明 ， 可 以 直接 在 
模板 输出 ， 以 下 是 ThinkPHP 支持 的 变量 : 





输出 语法 : 





7.2.2 配置 输出 


ThinkPHP 将 Config 中 定义 的 数组 也 “ 挂 载 ” 在 Think 变量 下 ， 以 下 语法 可 以 输出 配置 : 
配置 文件 中 定义 的 数据 为 : 


模板 中 可 以 采用 {6Think.config.version} 的 形式 输出 。 


7.2.3 测试 


编辑 Application/Home/Controller/IndexController.class.php 文件 ， 添 加 “view1l 方法 ”， 代 码 





编辑 Application/Common/Conf/config.php， 代 码 如 下 : 





由 于 需要 测试 的 是 系统 变量 ， 故 该 方法 不 进行 赋值 操作 。 由 方法 名 可 以 推断 出 模板 文件 路 径 
为 “Application/Home/Viwe/Index/view1.html”， 代 码 如 下 : 





打开 浏览 器 访问 http://localhost/thinkphp-inaction/chapter-7/index.php/home/index/ 
viewl?name=test， 可 以 看 到 页 面 输出 如 下 结果 : 


输出 Server 变量 :/thinkphp-inaction/chapter-7/index.php/home/index/view1?name=test。 
输出 Get 变量 : test。 

输出 Cookie 变量 : ei62hh0o2ul26166rdk7e7t114 ， 该 处 跟 有 具体 情况 有 关 。 

输出 配置 变量 : configname。 





了 .了 函数 


7.3.1 函数 类 型 


模板 中 也 可 以 使 用 函数 ， 这 是 不 是 很 神奇 呢 ? 

其 实 不 然 ， 得 益 于 ThinkPHP 的 模板 编译 系统 。 可 以 使 用 的 函数 包括 : PHP 内 置 函 数 、 
ThinkPHP 内 置 函数 、 用 户 自 定义 函数 、 类 静态 方法 。 

模板 中 使 用 函数 的 一 般 形式 为 : 


参数 大 于 一 个 的 函数 ， 例 如 在 模板 中 格式 化 时 间 玲 : 


由 于 date 函数 中 时 间 戳 参数 是 第 二 个 参数 ， 所 以 需要 使 用 “ 故 #” 作 为 占 位 符 。 
编译 成 PHP 的 代码 为 : 


参数 等 于 一 个 的 函数 ， 例 如 将 字符 串 转换 为 大 写 : 


编译 成 PHP 的 代码 为 : 


函数 嵌 套 调用 的 情况 ， 如 对 字符 串 MD5 之 后 再 截取 : 


PHP 模板 中 翌 套 函数 执行 顺序 是 “由 左 到 右 ” 执 行 ， 所 以 上 述 代码 编译 为 PHP 的 结果 为 : 


7.3.2 测试 


编辑 Application/Home/Controller/IndexController.class.php， 添 加 “view2” 方 法 ， 代 码 如 下 : 
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编辑 Application/Home/View/Index/view2.html， 代 码 如 下 : 


打开 浏览 器 访问 http://localhost/thinkphp-inaction/chapter-7/index.php/home/index/view2， 可 以 
看 到 浏览 器 输出 以 下 结果 : 





了 .4 变量 默认 什 


7.4.1 语法 形式 


ThinkPHP 模板 支持 变量 默认 值 ， 当 变量 值 为 空 的 时 候 ， 显 示 默 认 值 。 比 如 有 一 个 显示 用 户 
签名 的 需求 ， 当 用 户 签名 为 空 的 时 候 输 出 “该 用 户 什么 也 没 写 ”。 代 码 如 下 : 


默认 值 可 以 结合 函数 使 用 ， 例 如 : 
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7.4.2 测试 


编辑 Application/Home/Controller/IndexController.class.php， 添 加 “view3” 方 法 ， 代 码 如 下 : 





编辑 Application/Home/View/Index/view3.html， 代 码 如 下 : 





访问 : http://localhost/thinkphp-in-action/chapter-7/index.php/Home/Index/view3， 可 以 看 到 浏览 
器 输出 如 下 : 
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了 。 5 算术 运算 符 


7.5.1 语法 形式 


ThinkPHP 模板 中 支持 算术 运算 符 操作 ， 支 持 的 运算 符 包括 “+”“-” “*”“/” “9%6” 
<4H” “复合 运算 ”。 

在 使 用 运算 符 进行 计算 的 时 候 ， 如 果 操 作 数 是 数组 ， 则 只 能 使 用 标准 数组 访问 形式 ， 如 
“$a['name’]”， 不 可 以 使 用 “a.name”; 如 果 是 对 象 ， 只 能 使 用 标准 对 象 访问 形式 ， 如 “$a- 
>name”， 不 可 以 使 用 “aname”。 


7.5.2 测试 
编辑 Application/Home/Controller/IndexController.class.php， 添 加 “view4” 方 法 ， 代 码 如 下 : 





编辑 Application/Home/View/Index/view4.html， 代 码 如 下 : 
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访问 : http://localhost/thinkphp-in-action/chapter-7/index.php/Home/view/view4， 浏 览 器 输 
出 如 下 : 
数组 测试 : 





对 象 测试 : 
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了 .模板 继承 


7.6.1 语法 形式 


面向 对 象 基础 的 读者 知道 ， 类 是 可 以 继承 的 ， 子 类 可 以 调用 父 类 的 方法 ;而 ThinkPHP 的 模 
板 继承 类 似 ， 虽 然 模板 中 没有 方法 ， 但 是 父 模板 的 布局 样式 子 模板 可 以 直接 使 用 。 
关键 字 “block”、“extend” 的 说 明 如 下 。 


@ “block”: 在 父 模板 中 需要 子 模板 实现 的 区 块 声明 。 
@ “extend”: 用 来 声明 继承 的 父 模板 。 


每 个 区 块 由 <block></block> 标 签 组 成 ， 示 例 代码 如 下 : 


block 标签 必须 指定 name 属性 来 标识 当前 区 块 的 名 称 ， 这 个 标识 在 当前 模板 中 必须 是 唯一 
的 ，block 标签 中 可 以 包含 任何 模板 内 容 ， 包 括 其 他 标签 和 变量 ， 例 如 : 


还 可 以 在 区 块 中 加 载 外 部 文件 : 


下 面 我 们 看 一 下 示例 代码 。 
父 模板 : 
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子 模板 1: 


子 模板 2: 


“extend” 标 签 的 用 法 同 “include”。 





7.6.2 测试 


编辑 Application/Home/Controller/IndexController.class.php， 添 加 “view5”、“view6” 方 
法 ， 代 码 如 下 : 





编辑 Application/Home/View/Index/view_parenthtml， 代 码 如 7.6.1 中 父 模板 代码 。 
编辑 Application/Home/View/Index/view5.html， 代 码 如 7.6.1 中 子 模板 1 代码 。 
编辑 Application/Home/View/Index/view6.html， 代 码 如 7.6.1 中 子 模板 2 代码 。 


访问 http:Wlocalhostthinkphp-inaction/chapter-7/index.php/home/index/view5， 浏 览 器 输出 如 下 : 


访问 : http://localhost/thinkphp-inaction/chapter-7/index.php/home/index/view6， 浏 览 器 输出 如 下 : 
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了 .视图 包含 


普通 PHP 代码 中 可 以 使 用 “include” 或 者 “require” 来 包含 其 他 PHP 文件 ，ThinkPHP 中 模 
板 文件 也 支持 “include”。 


7.7.1 语法 形式 


7.7.2 ”模板 表达 式 
定义 规则 : 


如 以 下 定义 都 是 有 效 的 : 


为 了 兼容 旧版 本 ， 还 可 以 写作 如 下 形式 : 


7.7.3 ”模板 文件 
定义 规则 ;模板 文件 路 径 


7.7.4 测试 


编辑 Application/Home/View/Index/view_section1.html， 代 码 如 下 : 


编辑 Application/Home/View/Index/view7.html， 代 码 如 下 : 
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访问 地 址 http://localhost/thinkphp-inaction/chapter-7/index.php/home/index/view7， 浏 览 器 输出 


如 下 : 


view sectionl 
View sectionl 


view sectionl 


可 以 看 到 三 种 形式 都 可 以 正常 工作 。 





内 置 标签 


为 了 在 模板 中 进行 诸如 “判断 ”、 
ThinkPHP 内 置 标签 如 表 7-1 所 示 。 


标签 名 称 ”属性 列表 
include 


impo 


file、href、type、value、basepath 
name、id、offset、length、key、mod 
name、item、ke. 


Volist 
foreach 
for name、from、to、before、step 
Switch 
value 、break 
无 


name、value、type 


Case 
default 





compare 





Tange name、value、type 


present 


notpresent | name 


“循环 ”等 功能 ， 需 要 使 用 到 ThinkPHP 的 标签 库 功 能 。 


表 7-1 
说 明 
包含 模板 文件 
导入 资源 文件 (js、css) 
遍历 数组 
遍历 数组 或 对 象 
for 循环 
switch 
switch 分 支 (与 switch 配套 使 用 
默认 值 
比较 输出 (包括 eq、neq、lt、gt、egt、dt、heq、nhegq 等 别名 ) 
范围 判断 输出 (包括 in、notin、between、notbetween 别名 ) 
判断 是 否 赋值 
判断 是 否 没 有 赋值 










emp 


notempty 


name 








判断 是 否 为 空 
判断 是 否 不 为 空 








defined 
notdefined 





name 








判断 常量 是 否定 义 
判断 常量 是 否 没有 定义 





























define name、value 定义 常量 
name、value 变量 赋值 
condition 条 件 判断 
condition 条 件 判 断 
无 同 else 
使 用 原生 PHP 代码 无 
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7.8.1 volist 标签 


volist 标签 用 来 输出 数组 〈 通 常 是 二 维 数组 ) ， 在 使 用 前 需要 在 控制 器 中 进行 赋值 操作 。 
示例 代码 如 下 : 





模板 代码 如 下 : 


这 是 最 常用 的 方式 ， 笔 者 推荐 读者 使 用 这 种 方式 。 
高 级 用 法 : 


@ ”输出 列表 中 指定 位 置 的 记录 





表示 输出 list 中 第 5~15 条 记录 。 
@ 输出 偶数 行 记录 





value=“1”， 这 里 的 值 是 从 0 开始 的 。 
@ 换行 





表示 每 输出 5 行 额外 输出 一 个 换行 符 。 


109 


ThinkPHP 实战 】 
@ ”为 空 提示 


很 多 时 候 列 表 为 空 页 面 上 什么 也 不 显示 ， 这 样 会 给 用 户 困惑 ， 而 volist 提供 了 列表 为 空 的 操作 。 


@ 输出 键 名 
volist 内 部 使 用 foreach 进行 循环 ， 如 果 需 要 输出 每 行 的 键 名 ， 使 用 如 下 语法 : 


本 局 key 不 能 为 “key”， “key” 是 ThinkPHP 的 保留 变量 ， 用 来 输出 数组 索引 。 





7.8.2 foreach 标签 


foreach 标签 与 volist 标签 类 似 ， 用 法 比 volist 简单 ， 但 是 笔者 这 里 推荐 用 volist， 因 为 类 似 
的 功能 掌握 一 个 就 可 以 了 ， 太 多 容易 混淆 。 
foreach 使 用 如 下 : 





与 volist 不 同 的 是 ，volist 使 用 id， 而 foreach 使 用 item。 


7.8.3 for 标签 
某 些 场景 不 适合 用 foreach， 这 时 候 for 标签 就 派 上 用 场 了 ，for 标签 语法 如 下 : 





name 默认 为 “i”，step 值 默认 “1”。 
for 使 用 如 下 : 
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"CERES 


页 面 上 会 输出 1~99。 


7.8.4 _ switch 标签 
如 果 同 一 个 变量 需要 用 ff、else 判断 多 次 的 话 ， 推 荐 使 用 switch 标签 ， 语 法 如 下 : 








额外 说 明 : name 属性 可 以 使 用 函数 、 系 统 变量 。 
代码 如 下 : 





多 个 case 对 应 一 个 处 理 ， 使 用 “|” 分 割 。 
代码 如 下 : 





7.8.5 ”比较 标签 


比较 标签 用 于 简单 的 变量 比较 ， 如 果 需 要 处 理 复杂 表达 式 ， 请 使 用 if， 比 较 标 签 有 多 个 ， 用 
法 一 致 ， 语 法 如 下 : 





ThinkPHP 内 置 的 比较 标签 如 表 7-2 所 示 。 


id 
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@ neq 





112 























范围 判断 标签 
范围 判断 用 来 判断 给 定 的 变量 是 否 在 /不 在 某 个 范围 /集合 内 。ThinkPHP 内 置 的 范围 判断 标 
签 有 in、notin、between、notbetween 。 


@ in 


用 来 判断 变量 值 是 否 在 集合 内 ， 代 码 如 下 : 





@@ notin 


与 训 相 反 ， 用 来 判断 变量 值 是 否 不 在 集合 内 ， 代 码 如 下 : 





® 。 between 


用 来 判断 变量 是 否 在 范围 内 ， 支 持 数字 、 字 母 ， 代 码 如 下 : 





请 注意 ，value 只 支持 两 个 值 ， 如 下 代码 是 无 效 的 : 





实际 上 等 同 于 如 下 代码 : 
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| 
三 . 
去 
卫 
oD 
将 





® notbetween 


用 来 判断 变量 是 否 不 在 范围 内 ， 代 码 如 下 : 





7.8.6 empty 标签 
empty 是 很 常用 的 标签 ， 用 来 判断 变量 是 否 为 空 ， 用 法 : 





7.8.7 defined 标签 
defined 用 来 判断 常量 是 否定 义 ， 用 法 : 





7.8.8 ”标签 菩 套 


系统 内 置 的 标签 中 ，volist、switch、if、elseif、else、fbreach、 比 较 标签 、 范 围 判断 标签 、 
Cnot) empty、 (not) defined 等 标签 都 可 以 嵌 套 使 用 。 例 如 : 
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7.8.9 import 标签 


该 标签 用 来 导入 前 端 资源 ， 如 js，css。 
js 导入 用 法 如 下 : 


系统 就 会 将 Web 目录 下 的 以 下 文件 导入 : 


css 导入 用 法 如 下 : 


系统 就 会 将 Web 目录 下 的 以 下 文件 导入 : 


import 标签 支持 导入 的 起 始 路 径 ， 用 法 如 下 : 


系统 就 会 将 /Js/Vendor/Jqueryjs 导入 。 


7.8.10 使 用 原生 PHP 


某 些 场景 下 ThinkPHP 内 置 的 标签 可 能 满足 不 了 需求 ， 模 板 中 也 是 可 以 使 用 PHP 代码 的 ， 
语法 同 PHP 语法 。 


7.8.11 不 解析 输出 


有 些 场景 下 ， 需 要 直接 输出 模板 ， 比 如 在 写 文档 的 时 候 ， 这 时 候 可 以 使 用 “literal”， 语 法 
如 下 : 





执行 结果 如 下 : 
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了 .名 模板 布局 


很 多 时 候 开 发 一 个 Web 程序 ， 网 站 的 头 部 和 底部 基本 是 公用 的 ， 这 时 候 就 需要 模板 布局 功 
能 了 。 
假设 有 如 下 html: 


index.html 和 userhtml 都 需要 使 用 headerhtml 和 footerhtml， 在 前 面 的 内 容 讲 过 
“include”， 但 是 这 里 用 更 好 的 解决 方法 。 
定义 一 个 layouthtml 文件 ， 内 容 如 下 : 





而 index.html 可 以 写成 这 样 : 





可 以 看 到 模板 布局 确实 很 强大 。 


了 . ‖ 0。 模板 常量 蔡 搞 


为 了 避免 在 使 用 模板 时 对 路 径 有 疑问 ，ThinkPHP 特别 实现 了 一 个 模板 常量 替换 的 功能 ， 这 
些 常量 可 以 直接 在 使 用 ， 内 置 的 蔡 换 规则 如 表 7-3 所 示 。 
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表 7-3 


_ ROOT 当前 网 址 (不 包括 域名 ) 
当前 应 用 的 URL 地 址 (不 包括 域名 ) 


APP 
vos | Si RR | 
当 襄 
冯 





当前 操作 的 URL 地 址 (不 包括 名 ) 
当前 的 而 UPL 


模板 替换 


_PUBLIC _， 在 模板 中 默认 会 被 奉 换 为 “/Public”， 以 上 常量 区 分 大 小 写 。 
如 果 需 要 更 改 _PUBLIC ”的 值 或 者 需要 增加 新 常量 ， 可 以 在 配置 文件 中 定义 : 


由 于 “_PUBLIC ”在 模板 中 直接 输出 了 “_PUBLIC ”的 值 ， 如 果 需 要 输出 
“_PUBLIC ”这 个 字符 串 ， 可 以 在 “TMPL _PARSE_STRING ”中 定义 一 个 常量 ， 值 为 
“ PUBLICG ” 





了 . | 1 模板 注释 


由 于 ThinkPHP 对 模板 文件 进行 了 解析 ， 所 以 传统 的 HTML 注释 已 经 无 效 ，ThinkPHP 中 视 
图 文件 的 注释 如 下 。 
单行 注释 : 


注释 在 经 过 ThinkPHP 解析 后 不 会 出 现在 最 终 返 回 页 面 上 ， 而 HTML 注释 最 终 返 回 给 页 
面 。 
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7.12 wt 


由 于 标签 比较 多 ， 故 采用 统一 测试 的 形式 进行 。 
本 次 测试 代码 较 多 ， 请 按 步 又 进行 : 


@ ”编辑 /chapter-7/Application/Home/Controller/DemoController.class.php， 代 码 如 下 : 





@ 编辑 /chapter-7/Application/Home/View/Demomheaderhtml， 代 码 如 下 : 


@ ”编辑 /chapter-7/Application/Home/View/Demo/footer.html， 代 码 如 下 : 


@ ”编辑 /chapter-7/Application/Home/View/Demo/layout.html， 代 码 如 下 : 
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Demo 为 控制 器 的 名 称 ， 请 根据 实际 情况 修改 。 
@ ”编辑 /chapter-7/Application/Home/View/Demo/index.html， 代 码 如 下 : 
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@ 在 /chapter7 目录 下 新 建 “Public” 目 录 ， 然 后 在 “Public” 目 录 下 新 建 “J ”目录 ， 新 
建 “mainjs”， 代 码 如 下 : 


@ 访问 http://localhost/chapter-7/index.php/Home/Demo， 输 出 如 下 : 





中 第 7 章 模 村 





ThinkPHP 实战 





本 测试 代码 托管 在 GITHUB 上 ， 网 址 如 下 : 
https://github.com/xialeistudio/thinkphp-inaction/tree/master/chapter-7 


7.13 8 结 


本 章 内 容 较 多 ， 但 是 常用 的 主要 有 变量 输出 、 模 板 布局 、volist、eq、empty 这 几 个 。 
本 章 需 要 掌握 的 内 容 : 


@ 交 量 输出 
函数 调用 
模板 布局 
volist 标签 
eq 标签 

empty 标签 


本 章 可 以 扩展 的 内 容 : 


@ ”模板 继承 
@ ”网 套 标签 
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ThinkPHP 中 应 用 默认 是 调试 模式 ， 开 启 调试 模式 有 利于 在 开发 阶段 发 现 错误 并 解决 ， 虽 然 
此 举 会 牺牲 一 部 分 执行 效率 。 


吕 .]】 调试 模式 


调试 模式 的 开启 与 关闭 都 在 入 口 文件 中 通过 定义 常量 “APP_DEBUG” 来 进行 操作 。 





开启 调试 模式 后 ， 会 有 以 下 变化 : 


日 志 记 录 ， 任 何 错误 信息 和 调试 信息 会 进行 记录 
关闭 模板 缓存 

记录 SQL 日 志 

关闭 数据 库 字 段 缓存 

文件 大 小 写 敏 感 

开启 页 面 trace 


吕 .2 异常 处 理 


ThinkPHP 在 程序 发 生 异 常 的 时 候 不 仅 显 示 错误 信息 ， 还 会 将 trace 信息 显示 出 来 ， 便 于 查 
错 。 如 果 关闭 调试 模式 ， 则 只 会 输出 错误 信息 。 
如 果 在 业务 逻辑 处 理 的 时 候 需 要 手动 抛 出 异常 ， 例 如 : 
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此 时 可 以 使 用 ThinkPHP 自 带 的 “E” 函 数 进行 处 理 ， 代 码 如 下 : 





ThinkPHP 自 带 的 异常 显示 模板 路 径 为 “ThinkPHP/Tpl/think_exception.tpl”， 可 以 通过 配置 
“TMPL_EXCEPTION_FILE” 来 修改 。 
以 下 为 异常 模板 文件 中 可 以 使 用 的 变量 : 


$e['file"]: 发 生 异常 的 文件 名 。 
$e['line"]: 发 生 异常 的 行 数 。 
$e['message"]: 异常 信息 。 
$e['trace'"]: 异常 trace 信息 。 


抛 出 异常 后 会 显示 具体 的 异常 信息 〈trace 的 显示 取决 于 是 否 是 调试 模式 ) ， 如 果 想 在 出 现 
异常 时 统一 显示 ， 可 以 使 用 如 下 配置 : 


蝇 使 用 此 操作 之 后 ， 页 面 不 会 显示 异常 信息 ， 但 是 日 志 依旧 会 记录 异常 信息 。 
8.3 时 二 


在 程序 开发 过 程 中 ， 往 往 需要 使 用 持久 化 日 志 记 录 功 能 ， 比 如 在 处 理 订单 相关 业务 时 如 果 发 
生 异 常 ， 需 要 将 相关 的 上 下 文 进行 记录 ， 以 便 后 期 排查 。 这 时 候 就 需要 日 志 功 能 了 ，ThinkPHP 
已 经 内 置 了 日 志 系统 ， 需 要 做 的 仅仅 是 配置 而 已 。 

如 下 是 一 个 典型 的 日 志 配置 : 
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8.3.1 日 志 级 别 
ThinkPHP 内 置 日 志 级 别 如 表 8-1 所 示 。 








表 8-1 

日 志 级 别 说 明 

EMERG 严重 错误 ， 出 现 错 误 时 程序 无 法 运行 
ALERT 警戒 性 错误 ， 必 须 立 即 被 修正 
CRIT 临界 值 错误 ， 超 过 临界 值 的 错误 
ERR 一 般 错 误 

WARN 警告 错误 

NOTICE 通知 级 别 错误 

INFO 信息 级 别 

DEBUG 调试 输出 

SQL SQL 语句 ， 调 试 模式 下 有 效 
8.3.2 ”记录 方式 


目前 支持 File 、Sae， 有 需要 的 可 以 自行 扩展 ， 修 改 日 志 记录 方式 只 需要 更 改 
“LOG_TYPE” 配 置 ， 默 认为 “File”。 


8.3.3 写 入 日 志 


ThinkPHP 的 Log 类 提供 record 和 write 方法 记录 日 志 。 
record 方法 原型 如 下 : 





$level 为 日 志 级 别 ， 如 果 “LOG_LEVEL” 不 包括 当前 $level， 那 么 系统 不 记录 该 日 志 ; 如果 
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需要 强制 记录 ， 请 将 $record 设 为 “true”。 
write 方法 原型 如 下 : 





ThinkPHP 自 带 的 日 志 记录 方式 为 “File”、“Sae”。 


名. 人 4 变量 输出 


PHP 内 置 print r 和 var_dump 函数 ， 但 是 在 浏览 器 直接 使 用 的 时 候 输 出 “不 友好 ”， 比 如 不 
换行 。ThinkPHP 内 置 了 dump 函数 ，dump 函数 原型 如 下 : 





号 .5 执行 统计 


在 实际 开发 中 ， 如 果 需 要 对 一 段 代 码 进行 执行 过 程 统 计 ， 比 如 统计 执行 时 间 、 占 用 内 存 等 ， 
ThinkPHP 提供 了 “G” 函 数 ， 使 用 方法 如 下 : 
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如 果 服 务 器 支持 内 存 统计 的 话 ， 可 以 使 用 如 下 代码 输出 内 存 占用 : 


号 .6 sQL 输 出 


在 开发 中 ， 如 果 出 现 数据 库 操作 失败 的 话 ， 这 时 候 就 需要 将 PHP 最 终 执行 的 SQL 显示 出 
来 ，ThinkPHP 的 Model 提供 了 getLastSql 方法 来 返回 该 模型 最 后 执行 的 SQL 语句 。 


8.7 Wt 


8.7.1 异常 测试 


在 Web 目录 下 新 建 “ chapter-8 ”目录 ， 并 初始 化 应 用 ， 编辑 
Application/Home/Controller/IndexController.class.php 的 index 方法 ， 代 码 如 下 : 





访问 http://localhost/thinkphp-inaction/chapter-8/， 输 出 如 图 8-1 所 示 。 
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FILE: DAwamp\www\thinkphp-inaction\chapter-8\Application\Home\Controller\IindexController.class.php LINE: 14 
TRACE 


#0 DAwamp\wwwthinkphp-inaction\chapter-s\Application\Home\Controller\IndexController class php(14): ECwESWaFWw82WwE5WG5NBONE9wX9qw99WE8NXAFWAF) 
#1 [internal functionj: Home\ControlleNIndexController->index() 

#2 DAWampAwwwnthinkphp-inactiorAThinkPHPMLibraryThinkyApp class php(173) ReflectionMethod->invoke(Object(Home\ControllerJndexControllen) 

#3 DAWamp\wwwthinkphp-inaction\ThinkPHP\Library\Think\App.class. php(110): ThinkVApprinvokeAction(Object(Home\Controlle\IndexControllen), ‘index] 

#4 DAwamp\wwwAthinkphp-inaction\ThinkPHP\Library\ThinkMApp.class.php(204): Think\VApp-execO 

#5 DAwamp\wwwthinkphp-inaction\ThinkPHP\Library\ThinkAThink class php(120), Think\App-runO 

#6 DAwamp\wwwthinkphp-inaction\ThinkPHP\ThinkPHP.php(97): Think\Think:startD 

#7 DAwamp\wwwAthinkphp-inaction\chapter-\index php(14): requirefDAwampWwwwNthi 

#8 {main} 


ThinkPHP3231 Fast Bz Simple OOP PHP Framework} — [WE CAN DO FT JUST THINKT 





图 8-1 


可 以 看 到 文件 名 ,异常 行 数 都 出 来 了 ， 很 方便 调试 。 


8.7.2 日 志 测 试 
接 下 来 测试 日 志 功能 ， 继 续 编辑 该 文件 ， 添 加 log 方法 ， 代 码 如 下 : 





配置 Application/Home/Conficonfig.php， 代 码 如 下 : 





可 以 看 到 设置 的 日 志 记录 级 别 是 “EMERGALERTERR”， 访 问 http://localhost/thinkphp- 
inaction/chapter-8/index.php/home/index/log， 浏 览 器 并 没有 输出 ， 此 时 需要 查看 日 志文 件 ， 打 开 
Application/Runtime/Logs/Home/ 日 期 .Jog， 日 期 形 如 “16_06 29"”， 可 以 看 到 日 志文 件 的 最 后 有 如 
下 记录 : 
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可 以 看 到 Log::write(INFO - write，Log::INFO); 并 没有 真正 写 入 日 志 ， 原 因 在 于 配置 的 
“LOG LEVEL” 。 


8.7.3 ”变量 输出 测试 
继续 编辑 该 文件 ， 添 加 dump 方法 ， 代 码 如 下 : 





访问 http://localhost/thinkphp-inaction/chapter-8/index.php/home/index/dump， 输 出 如 下 : 





可 以 看 到 数据 以 及 数据 值 都 显示 出 来 了 。 


8.7.4 执行 统计 测试 
继续 编辑 该 文件 ， 添 加 profile 方法 ， 代 码 如 下 : 
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访问 http://localhost/thinkphp-inaction/chapter-8/index.php/home/index/profile， 输 出 如 下 : 


由 于 笔者 计算 机 是 Windows 系统 ， 可 能 不 支持 内 存 统 计 ， 所 以 输出 为 0KB。 


8.7.5 ”SQL 输出 测试 
打开 本 地 数据 库 ， 执 行 以 下 SQL 创建 示例 数据 表 并 插入 测试 数据 : 





编辑 Application/Home/Conf/config.php， 代 码 如 下 : 





编辑 Application/Home/Controller/IndexController.class.php， 添 加 db 方法 ， 代 码 如 下 : 
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访问 http://localhost/thinkphp-inaction/chapter-8/index.php/home/index/db， 输 出 如 下 : 





可 以 看 到 最 后 输出 了 SQL 语句 。 


号 .3 总结 


开发 中 总 会 遇 到 各 种 各 样 的 问题 ， 希 望 读 者 能 掌握 好 本 章 所 学 ， 遇 到 问题 时 能 够 自己 独立 调 
试 并 解决 。 

本 章 需 要 掌握 的 内 容 : 

@ 异常 处 理 

@ 日 志 记 录 

@ SQL 输出 

本 章 可 以 扩展 的 内 容 : 

@ ”执行 统计 

@ 日 志 级 别 
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在 实际 的 项 目 中 ， 由 于 MySQL 的 访问 瓶颈 ， 需 要 将 “ 热 数据 ”存放 到 缓存 中 提高 程序 的 性 
能 。ThinkPHP 支持 数据 缓存 、 页 面 缓存 、 查 询 缓存 等 缓存 方式 。 支 持 的 缓存 驱动 包括 APC、 
Db、Memcache、Xcache、Redis 等 。 


日 .〗 数据 缓存 


ThinkPHP 内 置 的 “S” 函 数 用 来 操作 数据 缓存 ， 包 括 写 入 缓存 、 读 取 缓 存 、 删 除 缓存 。 
S 函数 原型 如 下 : 





根据 传 入 参数 的 不 同 会 有 不 同 的 实现 方式 。 


9.1.1 写 入 缓存 
使 用 方法 如 下 所 示 : 


9.1.2 ” 读 取 缓存 
使 用 方法 如 下 所 示 : 


9.1.3 ”删除 缓存 
使 用 方法 如 下 所 示 : 


日 .2 页 面 缓存 


使 用 过 CMS (内 容 管理 系统 ) 的 读者 应 该 知道 CMS 一 般 会 有 个 生成 静态 页 面 的 功能 ， 毕 
竟 静 态 页 面 性 能 比 动态 页 面 性 能 高 。 

静态 缓存 的 开启 需要 手动 配置 “HTML CACHE ON”， 并 且 同 时 配置 
“HTML CACHE RULES”。 

配置 代码 如 下 所 示 : 





1. 访问 地 址 定义 
@ 全 局 的 action 规 则 ， 例 如 定义 所 有 的 view 操作 的 静态 规则 如 下 : 


表示 所 有 action 为 “view” 的 页 面 都 会 被 缓存 60 秒 ，{id} 表 示 $_GET['id)] 。 
@ ”全 局 的 controller 规则 ， 例 如 定义 所 有 的 Article 控制 器 的 静态 规则 如 下 : 


表示 所 有 的 article 的 操作 都 会 被 缓存 60 秒 ，{:action} 表 示 当 前 action 名 称 。 
@ ”特定 控制 器 特定 操作 的 规则 ， 例 如 定义 new 控制 器 的 view 操作 的 静态 规则 如 下 : 
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2. 静态 规则 定义 
静态 规则 是 用 于 定义 要 生成 的 静态 文件 的 名 称 ， 静 态 规则 的 定义 要 确保 不 会 冲突 ， 写 法 可 以 
包括 以 下 情况 : 
@ 使 用 PHP 变量 ， 包 括 $ GET、$_POST、$_SERVER、$_SESSION、$_COOKIE， 例 如 
以 下 代码 : 


@ ”使 用 ThinkPHP 交 量 ， 包 括 {:module}、f{:controller}、f{:action} 分 别 表 示 当 前 模块 名 、 控 
制 器 名 和 操作 名 。 例 如 : 


@ 使 用 函数 ， 使 用 形式 为 {|functionName}， 例 如 : 


@ 混合 使 用 ， 例 如 : 


3. 有 效 期 

单位 秒 ， 如 果 不 定义 ， 则 读 取 配置 参数 “HTML_CACHE_TIME”; 如 果 为 0， 则 永 不 过 期 。 
4 附加 规则 

一 般 对 定义 的 规则 附加 额外 的 函数 运算 ， 例 如 MD5 等 : 


日 .了 数据 库 查询 缓存 


对 于 及 时 性 要 求 不 高 的 数据 ， 可 以 使 用 数据 库 查询 缓存 ， 比 如 文章 列表 等 。 
ThinkPHP 的 Model 已 经 实现 了 cache 方法 ， 不 需要 用 户 自 己 实现 数据 库 查 询 缓存 。 使 用 方 
法 如 下 : 


如 果 使 用 了 cache(true)，ThinkPHP 在 查询 的 时 候 就 会 根据 查询 条 件 生成 一 个 唯一 的 缓存 标 
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识 ; 如 果 传 入 的 是 cache('keyname”") 这 种 形式 的 话 ，ThinkPHP 则 直接 使 用 keyname 作为 缓存 标 
识 名 。 


ThinkPHP 默认 采用 DATA_CACHE _ TYPE 参数 设置 的 缓存 方式 进行 缓存 ， 缓 存 时 间 为 
DATA_CACHE_TIME 参数 设置 的 时 间 ， 如 果 需 要 临时 改变 以 上 参数 ， 可 以 在 调用 cache 方法 时 
传 入 多 个 参数 。 代 码 如 下 : 


Smodel->cache (true,3600, xcache')->select0 
表示 当前 查询 使 用 xcache 缓存 一 个 小 时 。 


9.4 关 千 


缓存 在 实际 应 用 中 很 常用 ， 缓 解 了 很 大 一 部 分 数据 库 压力 ， 希 望 读 者 至 少 掌握 一 种 缓存 方 
法 。 本 章 的 代码 示例 将 在 实战 项 目 中 进行 演示 。 
本 章 需 要 掌握 的 内 容 : 


@ 数据 缓存 
@ 查询 缓存 


本 章 可 以 扩展 的 内 容 : 
@ 页 面 缓存 
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1 0. 1 session 操作 


ThinkPHP 提供 了 session 函数 来 代替 直接 操作 PHP 的 $_ SESSION。 默 认 情 况 下 ，ThinkPHP 
会 自动 启动 session， 如 果 不 需 要 自动 开启 session 方法 的 话 ， 可 以 配置 SESSION_AUTO_START 
为 false。 


10.1.1 session 写 入 


本 书 所 用 的 ThinkPHP3.2.3 还 支持 key 包含 “.”， 如 以 下 代码 在 ThinkPHP3.2.3 中 是 合 
法 的 : 


session(ruseruserIdD 
10.1.2 session 读 取 


如 果 ThinkPHP 版 本 是 3.2.3 的 话 ，key 也 支持 “.” 操 作 符 ， 代 码 如 下 : 


10.1.3 ”session 删除 


如 果 ThinkPHP 版 本 是 3.2.3 的 话 ，key 也 支持 “.” 操 作 符 ， 代 码 如 下 : 


第 10 章 专 


机 


如 果 清 空当 前 session 的 所 有 数据 ， 可 以 使 用 以 下 代码 : 


1 0.2 cookie 操作 


10.2.1 cookie 写 入 


10.2.2 “cookie 读 取 


10.2.3 读 取 所 有 cookie 


10.2.4 ”cookie 删除 


10.3 入 页 


10.3.1 分 页 语法 


分 页 操作 在 Web 开发 中 属于 很 常用 的 功能 ，ThinkPHP 内 置 了 对 分 页 的 支持 。 分 页 代码 也 很 
简单 ， 代 码 如 下 : 
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10.3.2 测试 
在 Web 目录 下 新 建 chapter-10 目录 并 初始 化 ThinkPHP 项 目 。 数 据 表 SQL 如下: 





编辑 Application/Common/Conf/config.php 的 数据 库 配置 〈 请 根据 实际 情况 配置 ) ， 代 码 
如 下 : 





编辑 Application/Home/Controller/IndexController.class.php， 添 加 insert 方法 插入 测试 数据 ， 
代码 如 下 : 
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访问 http://localhost/thinkphp-inaction/chapter-10/index.php/home/index/insert， 浏 览 器 会 输出 很 
多 “1”， 最 后 一 行 会 输出 “ok”， 此 时 数据 插入 完毕 ， 开 始 分 页 代码 编写 。 
编辑 IndexControllerclass.php 的 index 方法 ， 代 码 如 下 : 


接 下 来 编写 模板 代码 ， 新 建 Application/Home/View/Index/index.html， 代 码 如 下 : 








浏览 器 访问 http://localhost/thinkphp-inaction/chapter-10/index.php， 输 出 结果 如 图 10-1 所 示 。 








I username | password | 注册 时 间 | 更 3 
6 Phangsan |e3ceb5881a0alfdaad01296d7554868dj2016-04-07 14:54:18l2016-07-05 17:03:40| 
I hangshan0 |098d1l2c27ff2d0cad46e3ede53ab6ac5|2016-07-05 17:03:40|2016-07-05 17:03:40| 
BB ehansshanl |a696206a9dc2438fa8fdfcff6bf48807|2016-07-05 17:03:40|2016-07-05 17:03:40| 
Behansshan? |Pa82d155926265dcdla6bedbba37fc5dj2016-07-05 17:03:40|2016-07-05 17:03:40| 
Phangshan3 [e447446d7e1l3ee26aedb4371bf2142c3l2016-07-05 17:03:40|2016-07-05 17:03:40| 
[Phangshan4 la3c174d35c34ee8cdeb57a261d0ae0f1l2016-07-05 17:03:40|2016-07-05 17:03:40| 
[Phangshan5 |a2cda25bdd3f213b2c2c357a5390d90f|2016-07-05 17:03:40|2016-07-05 17:03:40| 
[Phangshan6 |B24c057835cf0d9978e26d273d7b522f|2016-07-05 17:03:40|2016-07-05 17:03:40| 
[Phangshan7 |d3b733d27ef4fb0dldfc921d09ad695|2016-07-05 17:03:40|2016-07-05 17:03:40| 
Phangshan8 |B79eacefd4c049c763a39e5f05b3a02a|2016-07-05 17:03:40|2016-07-05 17:03:40| 
6Phangshang |e667ae724e0172f774477a20deea4bgb|2016-07-05 17:03:40|2016-07-05 17:03:40| 
0 
0 
0 


| 可 
引 国 | 


[Phangshanl0l5c7e652964fb561d4ed165ef620f12fal2016-07-05 402016-07-05 17: 
8Phangshan1l500b2943ed0f56c40a6166758e48cf01|2016-07-05 402016-07-05 17: 
[Phangshan12lb675b2d4aeccc29f6f509c693681f769|2016-07-05 17:03:40|2016-07-05 17: 
OPhangshan13|2e00f1c2d1430balf8ba8098aga950adj2016-07-05 17:03:40|2016-07-05 17:03:40| 
Phangshan1468cd1l3ed5cdaf90cfe2agcae152cag70|2016-07-05 402016-07-05 1 
2Phangshan15|65ed7ad4fb2987764ac4847fe688delf|2016-07-05 17:03:40|2016-07-05 1 
3Phangshan16|5a6d039ed60e14084ae8alf6315d2697|2016-07-05 17:03:40|2016-07-05 1 
4Phangshanl7jrbc15154b21c1553b00f58c21dl10e80a|2016-07-05 17:03:40|2016-07-05 1 
5Phangshan18|877c3f32193401f36770b038790fbccl|2016-07-05 17:03:40|2016-07-05 17:03:40| 
6Phangshan19j76ee746d92f2cag5d403387232323801|2016-07-05 17:03:40|2016-07-05 17:0 
Thangshan20|3d7bfc9dfebda5810595846fb392f8a0|2016-07-05 17:03:40|2016-07-05 17:03:40| 
8hangshan21|a7ab7f00378e3016b0e22410d7bc2bl4j2016-07-05 402016-07-05 17:0: 
29hangshan22|f552bb74301e01ela3c44b52a0416b03|2016-07-05 17:03:40|2016-07-05 17:0 
B0hangshan23|11558830bae2e032f793d551524c1853|2016-07-05 17:03:40|2016-07-05 17:03:40| 
B]zbhangshan2470e95647albdc2396ac40c6e2d861f57|2016-07-05 17:03:40|2016-07-05 17:03:40| 
2hangshan25|c545f03497f2a2b8013ac6e3c6a223fal2016-07-05 17:03:40l2016-07-05 17:03:40| 
B3lzhangshan26 1dfaeeeef 1f0d58a70db6531f20a006l2016-07-05 17:03:40l2016-07-05 17:03:40| 
1234567 > 


7: 
7: 
7: 
7: 


0 
0 
0 
0 
0 


7: 
7: 


3 
3 
3 
3 
3: 
3: 
3: 
3 
3; 
3; 
3; 
3; 
3 
3: 
3 
3: 
3 1: 
3 


图 图 图 图 国 图 国 图 图 国 图 图 国 图 国 国 图 国 国 图 国 国 回 固 国 四 辐 


图 10-1 


图 10-1 左下 方 的 位 置 显示 出 了 分 页 链接 。 可 以 看 到 不 到 10 行 的 代码 就 可 以 实现 分 页 效果 


了 。 不 得 不 说 ThinkPHP 的 封装 做 得 很 人 性 化 。 
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10.4 文件 上 传 


文件 上 传 在 开发 中 也 用 得 非常 多 ， 比 如 编辑 个 人 资料 时 的 头像 上 传 等 。ThinkPHP 对 文件 上 
传 也 有 内 置 支持 。 

本 小 节 直接 用 代码 演示 如 何 使 用 ThinkPHP 内 置 的 文件 上 传 功能 完成 上 传 。 

编辑 IndexController.class.php， 添 加 upload 方法 ， 代 码 如 下 : 





新 建 Application/Home/View/Index/upload.html， 代 码 如 下 : 


form 的 enctype 请 设置 为 “multipart/form-data”， 这 是 上 传 文件 表单 必须 的 ，method 的 方法 
请 设置 为 “post”。 





编辑 IndexController.class.php， 添 加 upload_do 方法 ， 代 码 如 下 : 
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需要 注意 的 是 ， 上 传 成 功 一 般 返 回 的 是 文件 的 URL ， 所 以 这 里 需要 做 下 拼接 ， 
$infof'file"]['savepath"]， 这 里 是 取 文 件 保存 路 径 〈 相 对 于 附件 上 传 根 目 录 ) ， 其 中 “file” 为 前 端 
表单 文件 域 的 字段 名 。 

访问 http://localhost/thinkphp-inaction/chapter-10/index.php/Home/Index/upload， 可 以 看 到 有 一 
个 上 传 域 和 一 个 上 传 按钮 。 选 择 图 片上 传 ， 如 果 在 项 目 index.php 文件 同 级 没有 Uploads 文件 夹 的 
话 ，ThinkPHP 会 提示 上 传 根 目录 未 创建 ， 此 时 在 index.php 文件 同 级 创建 Uploads 文件 夹 即 可 。 

创建 完成 之 后 刷新 即 可 ， 选 择 图 片上 传 后 浏览 器 输出 如 下 : 

Uploads/2016-07-05/577b7e2e4c642.jpg 

读者 实际 输出 可 能 和 笔者 不 同 ， 这 是 由 于 ThinkPHP 根据 当前 日 期 一 起 md5 来 计算 文件 名 
所 致 。 

此 时 打开 Uploads 文件 ， 可 以 发 现 该 文件 夹 下 多 出 来 “2016-07-05” 的 文件 夹 ， 里 面 有 一 个 
名 为 “577b7e2e4c642.jpg” 的 图 片 。 证 明 图 片 已 成 功 上 传 。 


10.5 wirm 


验证 码 可 以 有 效 地 防止 机 器 人 之 类 的 提交 垃圾 数据 进 到 我 们 开发 的 Web 程序 ， 生 成 验证 码 
需要 使 用 GD 库 的 函数 ，ThinkPHP 将 验证 码 的 相关 操作 封装 成 了 一 个 类 供 开 发 者 调用 ， 大 大 简 
化 了 开发 工作 。 

接 下 来 用 一 个 示例 来 演示 如 何 使 用 ThinkPHP 来 进行 验证 码 的 相关 操作 。 


(1) 编辑 IndexController class.php， 添 加 verify 方法 ， 代 码 如 下 : 
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如 果 需 要 对 验证 码 进行 设置 ， 可 以 在 实例 化 之 后 对 属性 进行 设置 ， 设 置 完毕 后 调用 entry 方 
法 进行 验证 码 图 片 的 输出 。 表 10-1 是 ThinkPHP 可 以 设置 的 属性 列表 。 
表 10-1 
说 明 
验证 码 有 效 期 ， 单 位 秒 
是 否 使 用 背景 图 片 ， 默 认 false 
字体 大 小 ， 默 认 25 
是 否 使 用 混淆 曲线 ， 默 认 true 
是 否 添加 噪点 ， 默 认 tme 
验证 码 宽度 ， 为 0 时 自动 获取 
验证 码 高 度 ， 为 0 时 自动 获取 
验证 码 位 数 ， 默 认 5 
验证 码 字体 ， 默 认 随机 获取 
是 否 使 用 中 文 验证 码 ， 默 认 false 
背景 颜色 RGB 设置 ， 默 认 值 aray(243, 251, 254) 
验证 码 加 密 密 钥 ， 默 认 ThinkPHP.CN 
验证 码 字符 集合 
验证 码 中 文字 符 集合 


(2) 继续 编辑 IndexController.class.php， 添 加 login 方法 ， 代 码 如 下 : 














(3) 在 Application/Home/View/Index 下 添加 login.html 文件 ， 代 码 如 下 : 
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可 以 看 到 表单 的 请 求 地 址 为 “_URL_/login_do”， 验 证 码 图 片 的 地 址 使 用 U 函数 生成 ， 
这 样 做 的 好 处 是 假设 以 后 由 于 服务 器 环境 的 变更 要 更 改 URL 模式 的 话 ， 这 里 的 链接 也 会 实际 变 
化 。 而 img 的 onclick 函数 是 点 击 刷新 链接 ， 起 到 验证 码 刷新 的 作用 。 


@ 表单 编写 完毕 ， 此 时 编写 服务 端 处 理 远 辑 ， 编 辑 IndexController.class.php， 添 加 
login_do 方法 ， 代 码 如 下 ; 





到 此 ， 代 码 已 经 编写 完毕 ， 浏 览 器 访问 http://localhost/thinkphp-inaction/chapter- 
10/index.php/Home/Index/login， 浏 览 器 输出 如 图 10-2 所 示 。 














请 御 入 对 证 机 








图 10-2 
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证 明 验 证 码 功能 已 经 成 功 调用 。 
总 的 来 说 ， 使 用 验证 码 有 以 下 三 步 : 


@ 调用 Verify 的 entry 方法 输出 验证 码 图 片 ; 
@ ”将 img 的 src 属性 设置 为 第 1 步 中 的 URL; 
@ ”接收 表单 提交 的 验证 码 ， 并 调用 Verify 的 check 方法 进行 验证 。 


1 0 .6 图 像 处 理 


图 像 处 理 在 Web 开发 中 也 是 很 重要 的 一 环 ， 比 如 头像 裁剪 、 图 片 加 水 印 等 。 以 往 这 些 操作 
都 需要 调用 GD 库 函 数 ， 函 数 名 和 参数 都 难以 记忆 。ThinkPHP 将 这 些 操作 封装 成 了 Image 类 ， 
包括 裁剪 、 缩 略图 、 水 印 等 功能 。 

ThinkPHP 的 Image 类 支持 GD 库 和 Imagick 库 ， 这 是 PHP 目前 使 用 最 常用 的 两 种 操作 库 ， 
接 下 来 将 对 常用 操作 进行 实例 讲解 。 

在 chapter-10 的 index.php 同 级 新 建 Public， 并 在 Public 目录 下 新 建 images 目录 ， 放 入 一 张 
JPG 图 片 ， 命 名 为 “demojpg”。 


10.6.1 实例 化 Image 


如 果 使 用 的 是 Imagick 库 操作 的 话 ， 可 以 使 用 以 下 代码 实例 化 : 


ThinkPHP 已 经 对 这 两 种 库 做 了 封装 ， 读 者 不 用 关心 底层 实现 ， 直 接 调 用 ThinkPHP 提供 的 
接口 即 可 。 


10.6.2 ”获取 图 片 基本 信息 
编辑 IndexControllerclass.php， 添 加 imginfo 方法 ， 代 码 如 下 : 
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浏览 器 访问 http://localhost/thinkphp-inaction/chapter-10/index.php/Home/Index/imginfo， 
输出 如 下 : 





可 以 看 到 原 图 尺寸 为 550*275， 接 下 来 的 操作 将 以 该 图 片 为 例 。 


10.6.3 ”图 像 裁剪 


\Think\Image 类 中 提供 crop 方法 进行 图 像 裁剪 。 
crop 方法 原型 如 下 : 


编辑 Appliation/Home/ControllerIndexControllerclass.php， 添 加 crop 方法 ， 代 码 如 下 : 
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浏览 器 访问 http://localhost/thinkphp-inaction/chapter-10/index.php/Home/Index/crop， 浏 览 器 不 
会 输出 内 容 ， 此 时 查看 Public/images 目录 ， 发 现 已 经 多 出 来 “demo-crop-200x200.jpg”， 通 过 查 
看 图 片 信息 发 现 该 图 片 尺寸 为 200*200， 证 明 裁剪 成 功 。 


10.6.4 图 像 缩 略 图 


使 用 过 论坛 的 读者 都 知道 上 传 个 人 头像 时 一 般 是 上 传 高 清 大 图 ， 而 论坛 实际 显示 你 的 头像 时 
却 是 小 图 片 ， 这 里 就 是 用 了 缩 略 图 技术 。 
\Think\Image 提供 thumb 生成 图 像 缩 略 图 。thumb 方法 原型 如 下 : 





编辑 Application/Home/Controller/IndexController.lcass.php， 添 加 thumb 方法 ， 代 码 如 下 : 





浏览 器 访问 http://localhost/thinkphp-inaction/chapter-10/index.php/Home/Index/thumb， 浏 览 器 
不 会 输出 内 容 ， 此 时 查看 Publiciimages 目录 ， 可 以 发 现 已 经 多 出 来 “demo-thumb- 
200x200.jpg”， 通 过 查看 图 片 信息 可 以 发 现 该 图 片 宽度 为 200， 高 度 却 不 是 200， 因 为 ThinkPHP 
为 了 保证 图 像 内 容 完整 ， 默 认 使 用 了 “等 比例 缩 略 ”技术 。 如 果 需 要 其 他 生成 方式 ， 在 使 用 
thumb 的 时 候 传 入 第 三 个 参数 即 可 。 可 选 参数 如 下 : 
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10.6.5 水 印 

在 版 权 意识 日 渐 重要 的 今天 ， 图 像 水 印 技术 必 不 可 少 。\Think\Image 提供 water 方法 进行 水 
印 操作 。 

water 方法 原型 如 下 : 





准备 一 张 小 尺 寸 的 水 印 图 片 ， 命 名 为 “logo.png”， 放 置 在 Publicimages 目录 下 。 与 
“demo.jpg” 同 级 。 编 辑 Application/Home/Controller/IndexController.class.php， 添 加 water 方法 ， 
代码 如 下 : 





浏览 器 访问 http://localhost/thinkphp-inaction/chapter-10/index.php/Home/Index/water， 浏 览 器 不 
会 输出 内 容 ， 此 时 查看 Public/images 目录 ， 可 以 发 现 已 经 多 出 来 “demo-waterjpg”， 打 开 图 片 
查看 ， 可 以 看 到 图 片 右 下 角 已 经 加 上 了 水 印 。 
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10.7 8 结 


本 章 内 容 都 是 生产 中 常用 的 技术 ， 也 属于 “ 即 学 即 用 ”的 技术 ， 望 读者 能 好 好 掌握 。 
本 章 需 要 掌握 的 内 容 : 


session 操作 
cookie 操作 
分 页 操作 
文件 上 传 
验证 码 

图 像 缩放 
图 像 裁剪 
图 像 水 印 
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< 留言 板 项 目 实 战 > 


项 目 目的 


为 了 培养 读者 独立 开发 项 目的 能 力 ， 以 及 展示 从 零 开始 到 项 目 上 线 的 完整 步骤 ， 本 章 通 过 一 
个 简单 的 留言 板 示例 进行 展示 。 


项 目 需求 


用 户 注册 、 登 录 。 
发 表 留 言 。 
删除 本 人 留言 。 
查看 本 人 留言 。 


数据 表 设 计 
本 项 目 使 用 MySQL5.5 为 项 目 数据 库 ， 数 据 表 设计 思路 应 该 以 实际 需求 作为 出 发 点 。 依 照 
本 项 目 实际 需求 ， 可 以 发 现 需要 用 户 表 、 留 言 表 即 可 。 
需求 中 包含 用 户 注册 、 登 录 ， 所 以 用 户 表 需 要 有 账号 、 密 码 字 段 。 发 表 留言 以 及 删除 本 人 留 
言 可 以 确定 留言 表 需 要 留言 内 容 、 用 户 ID 字段 。 
所 以 本 项 目 最 终 数据 表 设 计 如 表 11-1 和 表 11-2 所 示 。 





表 11-1 
字段 名 数据 类 型 备注 
userld | | 用户 ID, 主键 ， 自 增 
Usermame varchar(40) 用 户 名 ， 字 符 串 
password, | char(32) | MDS5 加 密 后 的 密码 








createdAt | int | 注册 时 间 
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表 112 
messageld Int 留言 ID， 主 键 ， 自 增 
| content varchar(100) 留言 内 容 
| oreatedat int 留言 时 间 
| userld int 用 户 ID 








1 1 .4 模块 设计 


本 项 目 只 需要 用 户 和 留言 相关 功能 ， 所 以 只 需要 Home 模块 即 可 ， 控 制 器 /操作 规划 如 表 11-3 
所 示 。 
表 11-3 
控制 器 /操作 需要 登录 备注 
[ma | 
[um | 


[ua | 是 pa 本 
[ae | 是 PaN 柄 
[nm ls# |x | 





1 下。 与 ”编码 实现 


关于 如 何 初始 化 一 个 项 目 ， 在 前 面 的 章节 中 已 经 介绍 过 ， 这 里 不 再 獒 述 。 





11.5.1 编写 模型 


由 于 每 条 留言 消息 都 需要 关联 留言 者 信息 ， 所 以 需要 使 用 ThinkPHP 的 视图 模型 ， 新 建 
Application/Home/Model/MessageViewModel.class.php， 代 码 如 下 : 


<?Php 
/x 
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11.5.2 ”编写 留言 控制 器 


编辑 Application/Home/Controller/IndexController.class.php， 代 码 如 下 : 
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index 方法 中 使 用 了 ThinkPHP 提供 的 分 页 功能 ， 该 知识 在 10.3 小 节 中 有 详细 讲解 。 
do_post 方 法 接收 表单 值 ， 进 行 逻辑 判断 后 进行 入 库 操作 。 
delete 接受 留言 id， 判断 是 否 留 言 者 本 人 ， 进 行 删除 操作 。 
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11.5.3 ”编写 用 户 控制 器 


编辑 Application/Home/Controller/UserController.class.php， 代 码 如 下 : 
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人 








do_register 方法 是 用 户 注册 ， 该 方法 接收 表单 值 进行 逻辑 判断 且 将 原始 密码 加 密 后 入 库 ， 值 
得 注意 的 是 ， 由 于 账号 是 唯一 的 ， 所 以 需要 单独 判断 是 否 存在 ， 如 果 注 册 成 功 则 返回 登录 。 

do_login 方法 是 用 户 登 录 ， 该 方法 将 加 密 后 的 密码 同 数据 库 进 行 比 对 ， 可 以 防止 原始 密码 被 
泄露 ， 如 果 登 录 成 功 则 调用 session 方法 写 入 登录 信息 。 

logout 方法 是 用 户 退 出 登录 ， 如 果 用 户 未 登录 则 提示 需要 登录 ， 如 果 已 登录 则 销毁 所 有 


Session 。 
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11.5.4 ”编写 留言 列表 


新 建 Application/Home/View/Index/index.html， 代 码 如 下 : 
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由 于 登录 和 未 登录 都 是 用 同一 个 action， 所 以 需要 对 登录 状态 进行 判断 ， 如 果 已 登录 则 显示 
用 户 信息 ; 如 果 未 登录 ， 则 显示 登录 及 注册 按钮 。 


11.5.5 ”编写 留言 发 表 页 面 


新 建 Application/Home/View/Index/post.html， 代 码 如 下 : 





11.5.6 ”编写 用 户 登录 界面 


新 建 Application/Home/View/User/login.html， 代 码 如 下 : 
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11.5.7 编写 用 户 注 册页 面 


编辑 Application/Home/View/User/register.html， 代 码 如 下 : 
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] 1.6 运行 效果 


打开 http://localhostthinkphp-inaction/message-board/index.php， 可 以 看 到 如 图 11-1 所 示 留 言 
界面 。 


11.6.1 留言 界面 
留言 界面 如 图 11-1 所 示 。 


留言 板 


111 
留言 者 ，xialei 留言 时 间 : 2016-07-11 11:23:53 
22 





11-1 
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11.6.2 ”用 户 登 录 
单 击 登录 ， 进 入 如 图 11-2 所 示 表 单 。 





11.6.3 ”登录 后 留言 列表 


输入 账号 信息 后 单 击 “ 登 录 ”， 如 果 账 号 信息 通过 验证 的 话 ， 可 以 进入 如 图 11-3 所 示 界 
面 。 


欢迎 您 ! test 发表 留言 退出 登录 

111 

留言 者 ，xialei 留言 时 间 ，2016-07-11 11:23:53 
12 





图 11-3 


11.6.4 ”发 表 留 言 
单 击 “发 表 留 言 ”， 进 入 如 图 11-4 所 示 界 面 。 





11.6.5 留言 成 功 
输入 留言 内 容 后 单 击 “发 表 ”， 即 可 发 表 成 功 并 进入 如 图 11-5 所 示 界面 。 
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区 过 test 发 表 留言 退出 登录 
留言 者 ，test 留言 时 间 ，2016-08-11 16:31:54 删除 
111 


留言 者 ，xialei 留言 时 间 ，2016-07-11 11:23:53 
test 


1 
留言 者 ，xialei 留言 时 间 ，2016-07-11 11:07:02 





图 11-5 


如 果 是 自己 发 表 的 留言 ， 右 边 会 显示 “删除 ”， 单 击 “ 删 除 ”后 系统 将 删除 该 条 留言 并 刷新 
当前 页 面 。 


11.6.6 ”注册 页 面 
在 登录 页 面 单 击 “ 注 册 ” 后 打开 如 图 11-6 所 示 界 面 。 





1 1 .7 项 目 总 结 


至 此 ， 第 一 个 留言 板 项 目 就 结束 了 。 项 目 虽 小 ， 五 脏 俱 全 ， 这 是 一 个 “启蒙 型 ”的 项 目 架 
项 目 已 托管 至 github， 项 目地 址 : 


https://github.com/xialeistudio/thinkphp-inaction/tree/master/message-board 
如 有 任何 问题 请 提交 issues， 地 址 : 
https://github.com/xialeistudio/thinkphp-inaction/issues。 
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1 2 .1 项 目 目的 


本 博客 系统 项 目 目 的 如 下 : 

@ ”记载 个 人 学 习 、 工 作 、 生 活 上 一 些 值得 回味 的 事情 ， 以 及 一 些 值得 分 享 或 者 探讨 的 技术 。 
@ ”用 于 社会 沟通 和 交友 ， 和 他 人 分 享 自己 的 成 功 。 

@ 自我 学 习 、 自 我 提高 。 


12.2 需求 分 析 


提 到 博客 ， 大 部 分 人 都 不 会 陌生 ， 毕 竟 大 名 易 易 的 wordpress 可 是 业界 神话 。 本 章 需 要 实现 
的 也 是 一 个 博客 系统 。 当 然 ， 并 没有 wordpress 那么 强大 ， 不 过 “ 麻 淮 虽 小 、 五 脏 俱全 ”， 一 个 


博客 应 有 的 功能 还 是 需要 有 的 。 
写作 。 博 客 的 核心 功能 就 是 写作 ， 而 且 是 独自 写作 ， 有 写作 就 有 文章 ， 有 文章 就 涉及 文章 的 


分 类 、 发 表 、 编 得 、 删 除 。 

评论 。 既 然 项 目 目的 中 有 “用 于 社会 沟通 和 交友 ”， 那 么 社会 上 的 读者 如 何 与 作者 互动 呢 ? 
所 以 ， 评 论 功能 必 不 可 少 。 有 了 评论 就 需要 发 表 评 论 、 管 理 评论 。 

友情 链接 。 好 文章 如 何 让 别人 知道 昵 ? 单 凭 自己 的 力量 是 不 够 的 ， 所 以 合理 地 与 他 人 交换 友 
情 链接 是 博客 的 一 种 推广 手段 。 


1 2 .3 引 功能 设计 


通过 需求 分 析 的 结果 ， 可 以 总 结 出 博客 系统 需要 以 下 功能 : 
@ ”管理 员 登 录 、 修 改 密码 、 退 出 登录 . 
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文章 分 类 添加 、 编 辑 、 删 除 。 

文章 添加 、 编 辑 、 删 除 。 

发 表 评论 、 管 理 评论 。 

添加 友情 链接 、 删 除 友情 链接 、 展 示 友 情 链接 。 


1 2. 和 数据库 设 计 


根据 需求 分 析 以 及 功能 设计 ， 设 计 出 如 图 12-1 所 示 数 据 库 模型 。 





categoryIdINT artiderd INT commentid INT linkIdINT 
erame vARCHARC20) > tte VAROHARGA0) onidname VAROAR(20) Sname VARCHAR(20) 
SisNavTINYINTCD) is | descrpton VARCHARCGI00) FreatedAt INT ink VARCHARC100) 
atoal INT 1 | image vAROtaRC28) aeaiedip VAROAR(1S) 9 status TINYINT() 
Ssort TINYINT | |snsmr Scontent TEXT Ssort INT 
< >=eedatnr HOartdeld INT La 
eer | » 
| am TINYINT(D) OO 
SsortINT 
Scontent TEXT 
admintd NT ecategorvidINT 
9userame VARCHAR(20) | [3 


Spassword CHARG2) 
> reatedAt INT(10) 
SlognAtINT 

?loginlp VAROHAR(15) 





图 12-1 
可 以 看 到 分 类 表 、 文 章 表 、 评 论 表 之 间 存 在 关系 。 


1〗2 .5 数据 库 字典 


1. 文章 分 类 ( blog_category ) 
文章 分 类 表 设计 如 表 12-1 所 示 。 

















表 12-1 
字段 名 称 
categoryld int(10) 主键 ， 自 增 
name varchar(20) 分 类 名 称 
isNav, tinyint(1) 是 否 显示 在 导航 栏 
total int 文章 总 数 
sort tinyint(4) 排序 
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2. 文章 表 ( blog_article ) 
文章 表 设 计 如 表 12-2 所 示 。 


表 12-2 
字段 名 称 






int(11) 主键 ， 自 增 
Title varchar(40) 文章 标题 

varchar(100) 文章 简介 
文章 封面 
点 击 数 
文章 发 布 时 间 〈 时 间 戳 ? 
文章 更 新 时 间 
状态 〈 发 表 ， 不 发 表 ) 





























3. 文章 评论 表 ( blog_comment ) 
文章 评论 表 设 计 如 表 12-3 所 示 。 


字段 名 称 


Content 





4. 管理 员 表 ( blog_admin ) 























管理 员 表 设计 如 表 12-4 所 示 。 
表 124 
字段 名 称 字段 类 型 
adminId int 管理 员 ID 
| Usemame varchar(20) 用 户 名 | 
assword char(32) 密码 (md5 加 密 后 密 文 ) | 
createdAt int 账号 添加 时 间 | 
| loginAt int 最 近 登 录 时 间 | 
[loginIlp int 最 近 登 录 IP | 
5. 友情 链接 表 ( blog_link ) 
友情 链接 表 设 计 如 表 12-5 所 示 。 
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1 2 .6 模块 设计 


12.6.1 Admin 模块 


admin 为 后 台 管 理 模块 ， 需 要 管理 文章 、 分 类 、 评 论 、 友 情 链接 等 功能 。 所 以 根据 功能 应 该 
分 开 4 个 Controller 进行 处 理 。Controller 如 下 : 


@ ArticleController， 文 章 控制 器 . 

@ CategoryController， 分 类 控制 器 。 
@ CommentController， 评 论 控制 器 。 
@ LinkController， 友 情 链接 控制 器 。 


1. 权限 检测 


由 于 admin 模块 属于 受 保护 的 模块 ， 所 以 以 上 4 个 控制 器 必须 登录 后 才能 正常 访问 ， 为 了 不 
写 重 复 代 码 ， 需 要 新 建 一 个 控制 器 处 理 登录 检测 ， 以 上 4 个 控制 器 继承 该 基本 控制 器 实现 统一 权 
限 检测 。 

在 Admin 模块 新 建 BaseControllerclass.php， 添 加 _initialize 方法 ， 代 码 如 下 : 





需要 进行 权限 检测 的 控制 器 继承 BaseController 即 可 。 


2. 分 页 处 理 


由 于 该 博客 系统 是 一 直 在 线 上 运行 的 ， 所 以 数据 量 不 可 预测 ， 在 列表 页 需要 进行 分 页 处 理 。 
以 下 是 友情 链接 主页 的 分 页 代码 : 


| 
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3. 文章 分 类 模型 


文章 是 属于 分 类 的 ， 所 以 读 取 文 章 列表 的 时 候 需 要 将 分 类 信息 同时 查询 处 理 ， 这 里 使 用 
ThinkPHP 提供 的 ViewModel， 在 Common 模块 新 建 Model 文件 夹 ， 在 Model 文件 夹 下 新 建 
ArticleCategoryViewModel.class.php， 代 码 如 下 : 





ViewModel 的 知识 可 以 在 第 5 章 第 9 节 查 看 。 


4. 文件 上 传 

在 设计 文章 表 的 时 候 ， 有 个 封面 字段 ， 这 个 字段 是 用 来 保存 文章 封面 的 ， 所 以 需要 做 一 个 图 
片上 传 的 功能 。 为 了 贯彻 “模块 化 ”的 思想 ， 笔 者 特地 将 上 传 模块 抽象 出 来 ， 只 要 在 需要 上 传 的 
页 面 include 即 可 。 

在 Admin 模块 的 View 文件 夹 添加 Common 文件 夹 ， 在 Common 文件 夹 下 添加 
upload.html， 代 码 如 下 : 
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该 段 代码 与 一 般 代码 区 别 不 大 ， 但 是 重点 在 于 : 


如 果 当 前 页 面 定义 了 uploadCallback 函数 ， 则 将 上 传 后 的 结果 回调 到 该 函数 。 
上 传代 码 ， 编 辑 Admin 模块 下 的 Index 控制 器 ， 添 加 upload 方法 ， 代 码 如 下 : 
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使 用 时 直接 使 用 以 下 代码 引入 即 可 示例 代码 在 Application/Admin/View/Article/post.html 





由 于 回调 函数 已 经 写 死 了 “uploadCallback ”， 所 以 目前 来 说 该 上 传 组 件 一 个 页 面 只 能 使 用 


-个 


Admin 模块 比较 重要 的 功能 就 是 以 上 列 出 来 的 ， 其 他 功能 基本 上 都 是 添加 、 编 辑 、 列 表 、 
删除 功能 ， 由 于 篇 幅 关系 这 里 不 再 袭 述 ， 有 需要 的 读者 可 以 前 往 github 下 载 源码 : 


12.6.2 ” Common 模块 


1. 分 类 处 理 


Common 模块 是 公用 模块 ， 其 他 模块 公用 的 功能 可 以 放 在 该 模块 下 ， 比 如 上 文中 的 “文章 - 
分 类 模型 ”就 是 公用 Model， 所 以 放 在 Common/Model 下 。 

博客 系统 在 设计 文章 分 类 时 有 “isNav” 字 段 ， 该 字段 用 来 标识 分 类 是 否 是 导航 栏 中 的 分 
类 ， 所 以 可 以 明确 出 来 的 需求 有 : 


@ 读 取 属于 导航 栏 的 分 类 ( status 为 1 ) 
@ 读 取 不 属于 导航 栏 的 分 类 (status 为 0) 
@。 读 取 全 部 分 类 


而 以 上 需求 返回 值 都 是 一 致 的 ， 也 就 是 分 类 列表 ， 所 以 可 以 将 以 上 三 个 需求 封装 成 一 个 函 
数 ， 根 据 传 入 的 status 来 决定 返回 数据 。 
编辑 Application/Common/Common/function.php， 添 加 如 下 代码 : 
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该 函数 对 “isNav” 参 数 的 处 理 有 个 技巧 。 当 给 定 的 stauts 大 于 -1 时 可 以 发 现 添加 了 一 个 过 
滤 参 数 ， 如 果 status 等 于 -1 则 不 添加 ， 所 以 该 函数 可 以 实现 上 文中 提 到 的 三 个 需求 。 
2. 友情 链接 列表 


博客 系统 设计 了 友情 链接 功能 ， 如 果 是 在 控制 器 中 使 用 Model 查询 的 话 ， 每 个 需要 友情 链 
接 的 部 分 都 需要 查 一 次 数据 库 ， 会 产生 重复 代码 ， 所 以 读 取 友情 链接 需要 提取 函数 以 供 前 端 调 用 。 
编辑 Common/Conf/config.php 文件 ， 代 码 如 下 : 





3. 数据 库 字段 大 小 写 


在 使 用 ThinkPHP 的 Model 进行 数据 库 操作 时 ， 返 回 的 数据 键 名 总 是 大 写 的 。 查 看 
ThinkPHP 源码 发 现 ，ThinkPHP 默认 的 键 名 是 大 写 ， 由 于 ThinkPHP 采用 PDO 链接 数据 库 ， 可 
以 去 看 看 PDO 的 链接 参数 ， 查 看 ThinkPHP 默认 的 配置 文件 convention.php 发 现 ， 其 中 有 
“DB_PARAMS” 这 个 字段 ， 注 释 为 “数据 库 连 接 参数 ”， 所 以 猜测 应 该 是 该 字段 的 关系 。 笔 者 
查 资料 发 现 ，PDO 有 “PDO::ATTR_CASE” 这 个 参数 来 控制 大 小 写 。 

编辑 Common/Conf/config.php， 添 加 数据 库 配 置 ， 代 码 如 下 : 
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12.6.3 ”Home 模块 


1. 前 台布 局 








前 台 模块 公用 部 分 有 项 部 导航 栏 以 及 右边 的 文章 分 类 ， 左 边 为 主 内 容 区 域 ， 该 区 域 根据 访问 
的 页 面 不 同 而 不 同 ， 所 以 Home 模块 用 到 了 ThinkPHP 的 模板 布局 功能 
打开 首页 如 图 12-2 所 示 


111222 
© 013W 


直子 于 在 《 圭 子 ,理子 下 ) 说 ; 教 天 科大 任 于 星人 由 ， 台 先世 闪避 宙 ,克基 新 间 ， 大作 于 ， 空 信行 ， 行 并 有 所 
为 ， 抽 以 荔 时 佳 ， 局 总 及 所 不 能 。 丰 丰 轩 呈 托 综 大任 有， 


部 





ed 
Bai ET Fe 


图 12-2 
编辑 Common/Conf/config.php 文件 ， 添 加 以 下 代码 


司 后 ， i 


由 于 开启 模板 布局 后 ，ThinkPHP 会 默认 使 用 名 为 “layout” 的 模板 ， 所 以 需要 在 
Home/View 下 添加 layout.html 文件 。 该 文件 代码 如 下 





de 
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<volist name="links" id="item"> 


<a href="{$item.link}" target=" blank">{$item.name}</a> 


</volist> 
</div> 
</div> 
</div> 
</section> 
<script src=" 
</body> 
</html> 


该 布局 文件 用 到 了 模板 常量 ， 而 ThinkPHP 自 带 的 模板 常量 只 有 _PUBLIC _， 所 以 需要 在 
当前 模块 单独 定义 。 
编辑 Home/Conf/config.php 文件 ， 添 加 如 下 代码 : 


VENDOR /bootstrap/js/bootstrap.min.js"></script> 





'TMPL PARSE STRING' => array( 
VENDOR ' => '/thinkphp-inaction/blog/public/vendor', 


， 
' JS ' => '/thinkphp-inaction/blog/public/home/js', 

' Css ' => '/thinkphp-inaction/blog/public/home/css', 

' IMAGE ' => '/thinkphp-inaction/blog/public/home/images' 


i 
由 于 笔者 本 地 项 目 是 部 署 在 localhost/thinkphp-inaction 中 ， 所 以 在 定义 模板 常量 的 时 候 需 要 
写 全 ， 读 者 可 以 根据 自己 项 目 部 署 情 况 来 编辑 目录 地 址 。 


前 端 资源 的 目录 结构 如 图 12-3 所 示 。 





图 12-3 


笔者 在 实际 项 目 中 也 是 这 套 结构 ， 共 用 部 分 用 vendor 目录 ， 然 
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样 也 可 以 分 模块 不 同人 员 一 起 开发 一 个 项 目 而 不 会 冲突 。 

由 于 导航 栏 、 友 情 链接 、 全 部 分 类 这 几 个 功能 都 是 公用 功能 ， 所 以 不 能 在 IndexController 的 
index 方法 中 编写 读 取 数据 的 方法 ， 如 果 这 样 ， 会 导致 假如 不 是 访问 Index/index 的 时 候 ， 导 航 
栏 、 友 情 链 接 、 全 部 分 类 会 读 取 不 到 数据 而 报错 。 

所 以 在 模板 文件 中 使 用 调用 Common 模块 中 的 getCategory 和 getLinks 函数 ， 这 样 就 不 会 出 
现 读 取 不 到 数据 的 问题 了 。 

调用 代码 如 下 : 





请 注意 “<php>” 标 签 ， 在 模板 中 运行 PHP 的 话 需 要 使 用 该 标签 ， 变 量 定义 之 后 在 接 下 来 的 
代码 中 就 可 以 直接 使 用 ThinkPHP 的 模板 语言 进行 操作 了 。 

2. 评论 间隔 处 理 

由 于 博客 系统 的 评论 采用 的 是 ajax 异步 评论 的 方法 ， 如 果 有 人 恶意 提交 接口 刷 评论 而 系统 


不 做 处 理 的 话 ， 博 客 系统 数据 库 很 可 能 被 写 满 ， 所 以 需要 使 用 缓存 来 做 评论 间隔 处 理 。 
编辑 Home/Controller/IndexController.class.php， 添 加 comment 方法 ， 代 码 如 下 : 
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S$id 为 被 评论 的 文章 ID，$key = get_client_ip() . '-view-article-' . $id; 这 段 代码 使 用 ID+IP 的 方 
式 识别 当前 评论 用 户 ， 如 果 S 函数 返回 值 不 为 空 ， 证 明 缓存 有 效 期 内 〔 本 代码 示例 中 为 1 分 
钟 ) 已 经 评论 过 ， 所 以 需要 返回 “评论 间隔 必须 大 于 1 分 钟 ”的 错误 信息 。 

如 果 评 论 成 功 ， 则 使 用 当前 $key 写 入 缓存 ， 有 效 期 1 分 钟 。 


3.Ajax 评 论 
为 了 提升 用 户 体 验 ， 在 文章 页 评论 功能 的 开发 中 使 用 Ajax。 打 开 
Home/View/Index/article.html (请 先 下 载 源码 ) ， 看 到 最 下 面 的 部 分 ， 代 码 如 下 : 
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在 提交 的 时 候 使 用 “$.post” 方 法 提交 。 在 回调 函数 中 需要 先 判断 是 否 出 错 ， 如 果 出 错 则 显 
示 错 误 信 息 ， 否 则 显示 该 评论 。 显 示 评 论 使 用 的 是 jQuery 的 prepend 方法 ， 因 为 最 新 的 评论 在 最 
前 面 ， 所 以 需要 将 生成 的 html 添加 到 最 前 面 。 


1 2 .7 项 目 总 结 


由 于 本 博客 系统 代码 量 略 多 ， 本 章 只 截取 经 典 的 、 也 是 常用 的 功能 模块 进行 重点 介绍 ， 和 希望 
大 家 在 本 项 目 中 多 花心 思 ， 该 项 目 可 以 直接 上 线 运行 。 这 也 是 大 家 自己 动手 开发 的 第 一 个 线 上 项 
目 ， 具 有 个 人 学 习 ThinkPHP 历程 中 划时代 的 意义 。 

项 目 已 托管 至 github， 项 目地 址 : 

https://github.com/xialeistudio/thinkphp-inaction/tree/master/blog 

如 有 任何 问题 ， 请 提交 issues， 地 址 : 

https://github.com/xialeistudio/thinkphp-inaction/issues 
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中 本 .1 项 目 目的 


在 网 络 飞 速 发 展 的 今天 ，Internet 成 为 人 们 快速 获取 、 发 布 和 传递 信息 的 重要 渠道 ， 众 所 周 
知 ， 论 坛 是 当今 网 络 中 的 知名 服务 之 一 。 它 开辟 了 一 块 “ 公 共 ” 的 空间 供 所 有 用 户 发 表 和 读 取信 
息 ， 允 许 用 户 对 自身 感 兴趣 的 话题 展开 讨论 ， 从 而 起 到 集思广益 的 作用 。 

本 项 目 将 从 零 开 始 开发 一 个 论坛 系统 ， 通 过 这 个 案例 的 开发 使 各 位 读者 能 学 以 致 用 。 


13.2 功能 设计 


本 系统 虽然 比较 小 ， 但 是 “ 麻 洗 虽 小 五 脏 俱全 ”， 该 有 的 功能 还 是 要 有 的 。 大 致 有 以 下 功 


版 块 管理 : 版 块 添加 、 版 块 编辑 、 版 块 删除 。 

评论 管理 : 发 表 评论 、 评 论 列表 、 评 论 删除 。 

帖子 管理 : 发 布 帖子 、 帖 子 编辑 、 帖 子 列表 、 帖 子 删除 。 
用 户 管理 : 用 户 列 表 、 用 户 编辑 、 用 户 个 人 主页 。 


本 .了 数据 库 设计 


根据 功能 设计 ， 可 以 设计 出 如 图 13-1 所 示 的 数据 库 模 型 。 
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userid INT 








boardd INT | 9 usemame VARCHAR(20) 
> name VARCHAR(O) | ——#| 9 password CHAR(32) 
9 icon VARCHAR(200) | 二 一 | 9 nianame VARCHAR(10) 
> enabled TINYINT 1 1 9 avatar VARCHAR(200) 
9 rules TEXT | | er | y createdAt TIMESTAMP 
| Doel NT 于 定夺 车 
= | 3 Mie VARCHAR(40) | ia 
1 3 viewCount INT 1 ne 
9 repyCountINT | i 
YcreatedAt TIMESTAMP bj—! 
paateahTMESTAMP 所 wa 
Err br | ocomenTExT adminkd INT 
ee EE pir > usemame VARCHAR(20) 
Om | a od 9 password CHAR(32) 
wa 1 六 9 ognAtTIMESTAMP 
Gu | Ey | 人 bgnpINT 
[| | (mis 


图 13-1 


3 引 ,4 数据 库 字 典 


1. 帖子 表 ( bbs_post ) 
帖子 表 设 计 如 表 13-1 所 示 。 


字段 名 称 


























2. 版 块 表 ( bbs_board ) 
版 块 表 设计 如 表 13-2 所 示 。 
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表 13-2 

















3. 回帖 表 ( bbs_reply ) 
回帖 表 设 计 如 表 13-3 所 示 。 





表 13-3 
字段 名 称 类 型 说 明 
| 
回复 时 间 
or 





4. 用 户 表 ( bbs_user ) 












用 户 表 设 计 如 表 13-4 所 示 。 
表 134 
字段 名 称 E34 
| 
varchar(200) 
























createdAt timestamp 注册 时 间 
createdIp 注册 全 《使 用 ip2long 转换 ) 
Score 积分 
L_postCount 发 帖 数 
5. 管理 员 表 ( bbs_admin ) 
管理 员 表 设计 如 表 13-5 所 示 。 
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本 .5 模块 设计 


由 于 论坛 管理 和 普通 成 员 的 操作 权限 不 同 ， 故 本 系统 采用 模块 化 开发 机 制 ， 使 用 以 下 3 
个 模块 : 

@ ”Common: 存放 公用 代码 ， 不 可 以 通过 Web 访问 。 

@ Home: 普通 用 户 可 以 访问 。 

@ Admin: 管理 员 可 以 访问 。 


13.5.1 Common 模块 


1. 配置 
本 模块 为 应 用 公用 模块 ， 所 以 本 模块 需要 配置 数据 库 、_PUBLIC__ 目 录 等 ， 完 整 的 配置 内 
容 如 下 (Application/Common/Conf/config.php》: 





论坛 系统 项 目 实战 








“DEFAULTavatar” 的 配置 是 默认 头像 ， 比 如 用 户 没有 上 传 自己 的 头像 ， 此 时 需要 使 用 默 
认 头 像 来 保证 用 户 个 人 主页 有 头像 。 
数据 库 配置 如 下 (Application/Common/Conf/db.php》: 





2. 模型 


本 节 将 选择 比较 经 典 的 功能 进行 讲解 ， 一 般 的 CURD 操作 我 相信 各 位 读者 应 该 都 学 会 了 ， 
如 果 对 模型 的 基本 操作 有 疑问 的 话 ， 可 以 复习 下 之 前 的 内 容 。 


(1) 解决 主键 不 为 ID 的 问题 
由 于 ThinkPHP 模型 的 默认 主键 名 为 ID ， 而 在 本 项 目的 数据 库 设 计 中 ， 我 们 使 用 了 具体 的 
名 称 ， 比 如 帖子 表 的 主键 为 posttd， 此 时 如 果 使 用 ThinkPHP 的 find 方法 直接 传 入 主键 ID 查询 
数据 库 时 是 查 不 出 结果 的 。 
更 改 模型 的 主键 名 称 其 实 很 简单 ， 查 看 Model 的 源码 可 以 发 现 $pk =“'id"， 只 需要 在 定义 子 
类 的 时 候 覆 盖 掉 这 个 属性 即 可 。 比 如 PostModel 的 主键 我 们 使 用 如 下 代码 定义 : 
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(2) 记录 管理 员 登 录 时 间 

记录 最 后 一 次 登录 时 间 。 使 用 过 网 银 的 读者 应 该 知道 在 登录 的 时 候 ， 系 统 会 提示 上 次 登录 时 
间 ， 以 此 提醒 用 户 上 次 是 否 为 本 人 登录 。 

而 记录 最 后 一 次 登录 时 间 的 功能 实现 要 求 有 以 下 两 点 : 


@ 本 次 登录 的 时 候 需要 显示 上 次 登录 时 间 
@ 本 次 登录 时 间 需 要 记录 


针对 这 两 个 需求 ， 可 以 发 现 需要 操作 数据 库 来 保存 本 次 登录 时 间 ， 但 是 上 次 登录 时 间 如 何 处 
理 呢 ? 

答案 是 使 用 session， 登 录 的 时 候 先 将 数据 库 中 记录 的 上 次 登录 时 间 写 入 session， 然 后 将 本 
次 登录 时 间 写 入 数据 库 。 这 样 在 网 页 看 到 时 是 上 一 次 登录 时 间 ， 而 下 一 次 登录 的 时 候 显示 的 就 是 
本 次 登录 时 间 。 

代码 如 下 (Application/Common/Model/AdminModel.class.php》 : 








(3) 帖子 视图 模型 定义 
本 模型 父 类 为 ViewModel， 需 要 展示 的 数据 来 自 帖子 表 、 用 户 表 以 及 版 块 表 ， 定 义 的 关联 如 
下 (Application/Common/Model/PostViewModel.class.php) : 
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(4) 帖子 浏览 数 统计 频率 

在 用 户 浏览 帖子 的 时 候 ， 需 要 将 帖子 浏览 数 +1， 而 如 果 在 页 面 访问 一 次 就 十 !， 得 到 的 数据 
似乎 不 太 准确 ， 比 如 用 户 如 果 短 时 间 内 重复 刷新 ， 这 个 应 该 算 作 一 次 访问 。 这 时 候 就 需要 使 用 缓 
存 来 控制 统计 频率 。 

代码 如 下 (Application/Common/Model/PostViewModel.class.php): 





ThinkPHP 实战 





这 里 使 用 了 默认 的 缓存 系统 ， 统 计策 略 如 下 : 


@ ”用 户 已 登录 时 ， 使 用 “用 户 ID+ 帖 子 ID" 作 为 缓存 key， 保 证 1 个 用 户 在 1 个 小 时 内 对 同 
一 篇 帖子 的 访问 计数 +1。 

@ 用户 未 登录 时 ， 使 用 "访问 IP+ 帖 子 ID" 作 为 缓存 key， 保 证 1 个 IP 在 一 个 小 时 内 对 一 
篇 帖子 的 访问 计数 +1 


13.5.2 ”Admin 模块 
管理 员 模块 提供 对 论坛 系统 的 各 项 配置 、 数 据 管理 等 功能 。 
认证 系统 设计 
考虑 到 本 项 目 后 台 模块 的 管理 员 登 录 功 能 是 不 需要 检测 管理 员 权限 的 ， 而 且 有 些 后 台 接口 可 


能 也 不 需要 登录 就 可 以 操作 ， 所 以 需要 设计 一 个 公用 类 来 提供 后 台 控制 器 的 公用 方法 。 
公用 类 代码 如 下 (Application/Admin/Controller/BaseController.class.php》: 
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loginRequired 为 protected 方法 ， 可 以 被 子 类 重 写 。 在 _initialize 方法 中 程序 根据 当前 类 ( 运 
行 时 是 哪个 类 就 是 哪个 类 ， 具 体内 容 可 以 参看 “PHP 延迟 静态 绑 定 ”) 的 loginRequired 方法 决 
定 当前 操作 是 否 需要 登录 。 

由 于 loginRequired 方法 默认 返回 “true”， 故 所 有 操作 都 需要 登录 ， 而 在 请 求 登录 时 是 不 能 
检测 登录 的 (此 时 管理 员 还 没 登 录 ) ， 示例 代码 如 下 
(Application/Admin/Controller/AuthController. class.php) : 
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由 于 AuthController 重 写 了 loginRequired 并 返回 false， 所 以 AuthController 可 以 在 不 登录 的 
状态 下 正常 请 求 。 
注意 : 静态 延迟 绑 定 在 设计 公用 类 的 时 候 是 很 常用 的 。 


13.5.3 ”Home 模块 


前 台 模 块 大 部 分 功能 都 是 直接 操作 数据 库 ， 所 以 本 文 不 再 著述 ， 需 要 的 读者 可 以 参看 随 
书 代 码 。 


登录 后 重 定向 到 登录 之 前 页 面 


先 来 介绍 一 个 场景 ， 你 正在 浏览 一 篇 帖子 ， 觉 得 写 的 很 不 错 ， 打 算 回 复 一 下 ， 此 时 你 还 没 登 
录 ， 在 你 单 击 登录 后 ， 浏 览 器 前 往 了 登录 页 面 ， 而 登录 成 功 后 ， 系 统 却 重 定向 到 了 首页 ， 你 一 时 
找 不 到 刚才 那 篇 帖子 了 当然 ， 打 开 浏 览 器 历史 记录 是 可 以 找到 的 ) ， 那 这 时 候 就 属于 “信息 丢 
失 ” 问 题 。 

正常 的 需求 是 登录 后 需要 重 定向 到 登录 前 的 页 面 ， 可 以 让 用 户 继续 操作 ， 这 个 功能 需要 使 用 
session 实现 。 示 例 代码 如 下 (Application/Home/Controller/CommonController.class.php)》: 
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checkLogin 为 登录 检测 方法 ， 在 需要 登录 时 才 调用 ， 此 时 如 果 用 户 未 登录 ， 则 将 当前 URL 
写 入 session 并 重 定向 到 登录 页 。 
再 来 看 下 登录 迎 辑 部 分 ， 代 码 如 下 (Application/Home/Controller/UserController.class.php》: 





在 登录 成 功 后 ， 系 统 读 取 sesstion， 如 果 session 未 设置 ， 则 重 定向 到 首页 ， 反 之 则 重 定向 到 
登录 之 前 的 页 面 ， 保 证 了 用 户 操作 流程 不 被 打 断 。 


1 3 引 .6 项 目 总 结 
本 系统 的 核心 仍然 是 数据 的 CURD 操作 ， 但 本 章 并 没有 花 多 少 内 容 介 绍 这 个 ， 相 信 读 者 们 
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对 这 个 操作 相当 熟悉 了 。 本 章 介绍 了 实际 开发 中 用 到 的 常用 功能 ， 希 望 大 家 可 以 举一反三 。 比 如 
在 Admin 模块 的 loginRequired 与 检测 登录 时 ， 本 文 介绍 的 方法 是 访问 controller 就 会 调用 
loginRequired 方法 。 有 兴趣 的 读者 可 以 修改 一 下 实现 “访问 action 时 才 调 用 loginRequired 方 
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， 这 样 系统 会 更 灵活 ， 粒 度 更 细 。 
项 目 已 托管 至 github， 地 址 为 : 
https://github.com/xialeistudio/thinkphp-inaction/tree/master/bbs 


如 有 任何 问题 请 提交 issues， 地 址 为 : 
https://github.com/xialeistudio/thinkphp-inaction/issues 





14.1 项 目 目的 


随 着 移动 互联 网 和 微 信 的 发 展 ， 微 信 已 经 成 为 人 们 生活 中 不 可 或 缺 的 一 部 分 ， 而 基于 微 信 公 
众 号 开展 的 服务 也 是 非常 多 。 比 如 想 订 机 票 的 话 ， 只 需要 关注 相应 公众 号 ， 回 复 一 下 出 发 地 和 目 
的 地 以 及 日 期 就 可 以 查 到 航班 ， 可 以 说 是 非常 方便 。 

本 章 将 和 大 家 一 起 学 习 一 下 微 信 公众 号 开发 中 常用 的 “被 动 消息 回复 ”功能 以 及 “ 自 定义 菜 
单 ” 功 能 。 


14.2 weiait 


本 章 在 用 户 与 公众 号 传统 的 一 问 一 答 上 增加 了 “会 话 ” 的 功能 ， 我 们 知道 ， 用 户 与 微 信 公众 
号 交互 流程 如 下 : 


(1) 用 户 向 公众 号 发 送 消息 。 

(2) 微 信服 务 器 将 接收 到 该 消息 并 将 该 消息 发 送 给 开发 者 服务 器 。 
(3) 开发 者 服务 器 接收 到 消息 经 过 处 理 后 返回 响应 。 

(4) 微 信服 务 器 将 该 响应 发 送 给 用 户 。 


可 以 看 到 在 整个 流程 中 我 们 只 有 第 3 步 才 能 做 处 理 。 本 章 的 项 目 拥有 以 下 功能 : 
@ 自 定 义 菜单 

用 户 注册 

用 户 登 录 

用 户 查看 个 人 资料 

用 户 上 传 头像 
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@ ”用户 退出 登录 


我 们 知道 ， 在 整个 交互 流程 中 是 没有 cookie 的 ( 微 信服 务 器 推送 的 时 候 不 带 cookie) ， 按 
照常 理 ，cookie 不 能 使 用 的 情况 下 ，session 是 不 能 使 用 的 ， 更 谈 不 上 “登录 ”之 类 的 功能 

其 实 ， 看 过 PHP 关于 session 的 介绍 后 可 以 知道 ，cookie 只 是 传输 session id 的 一 种 手段 ， 
在 Web 开发 早期 ， 用 户 将 cookie 禁用 后 ， 通 过 配置 PHP 的 参数 可 以 在 URL 中 传输 session_id。 
此 外 ，PHP 提供 session_ id 函数 ， 接 收 一 个 可 选 参 数 ， 如 果 用 户 传 入 该 参数 ，PHP 则 将 传 入 的 参 
数 作为 当前 的 session id。 

前 面 提 到 这 么 多 ， 目 的 只 有 一 个 一 一 只 要 能 传输 session id， 会话 就 能 实现 。 在 整个 交互 流 
程 中 ， 用 户 的 openid 是 不 变 的 。 所 以 我 们 可 以 将 openid 作为 会 话 ID 来 实现 session 。 








开通 测试 公众 号 


人 ID 打开 浏览 器 ,输入 http://mp.weixin.qq.com/debug/cgi-bin/sandbox?t=sandbox/login， 如 图 
13-1 所 示 





委 信 号 扫 一 扫 整 录 
锡 广 册 “ 方 全 人 各 


耕作 已 注册 手机 桥 雪 ， 测 


图 13-1 
人 2 单 击 “ 登 录 ” 按 钮 ， 打开 如 图 13-2 所 示 页 面 ， 使 用 微 信 扫描 二 维 码 


微 信 登 录 





图 13-2 
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人 603 在 手机 上 点 击 确认 登录 之 后 ， 就 会 成 功 申请 一 个 微 信 测 试 公众 号 。 
人 4 登录 成 功 之 后 ， 浏 览 器 会 跳 转 到 如 图 13-3 所 示 的 页 面 ， 此 时 ， 我 们 可 以 开始 开发 。 





图 13-3 
从 前 面 的 交互 流程 中 可 以 看 出 ， 第 3 步 微 信服 务 器 会 推送 消息 到 开发 者 服务 器 ， 所 以 我 们 需 
要 一 台 运行 在 线 上 的 服务 器 ， 各 位 读者 可 以 自行 购买 ， 国 内 的 阿里 云 、 百 度 云 、 新 浪 云 、 腾 讯 云 
都 可 以 ， 具 体 看 大 家 自己 。 





下 载 开发 类 库 


微 信 服务 器 向 开发 者 服务 器 推送 数据 的 时 候 ， 采 用 的 是 xml 格式 的 数据 ， 这 时 候 我 们 需要 
对 消息 进行 解码 并 根据 不 同 的 消息 类 型 进行 不 同 的 处 理 ， 其 实 这 个 解码 过 程 我 们 没有 必要 手动 
发 ， 网 络 上 已 经 有 热心 的 开发 者 开源 了 一 个 “ThinkWechat” 的 项 目 ， 该 项 目 封装 了 对 微 信 推 送 
消息 的 解码 ， 包 装 开发 者 服务 器 返回 的 响应 消息 的 功能 。 

该 文件 代码 地 址 如 下 ， 读 者 可 以 直接 下 载 该 文件 。 














https://github.com/xialeistudio/thinkphp- 
inaction/blob/master/wechat/Application/Home/Library/ThinkWechat .php 





fl!l 
1 和 ,了 开始 会 话 开发 
本 D0 新 建 项 目 “wechat” 并 且 初 始 化 ， 将 下 载 的 ThinkWechat 类 库 放 置 于 


Application/Home/Library 目录 下 。 
人 2 更 改 Application/Home/Conf/config.php 文件 ， 代 码 如 下 : 


19F 


ThinkPHP 实战 


各 位 读者 请 根据 自己 的 测试 公众 号 更 改 appid 以 及 secret。 

在 本 项 目的 开发 中 ， 由 于 涉及 用 户 操作 步 又， 比如 用 户 查看 个 人 资料 的 时 候 系统 需要 检测 是 
否 登 录 ， 而 是 否 登录 由 session 保存 。 所 以 需要 将 THINKPHP 自动 开启 session 的 选项 设置 为 
人 lse， 这 样 才能 在 我 们 将 openid 设置 为 session_id 之 后 开启 session。 此 外 ， 用 户 的 操作 步骤 也 使 
用 session 存储 ， 并 且 将 该 步骤 定义 为 常量 。 

编辑 Application/Home/ControllerIndexControllerclass.php， 定 义 常 量 ， 代 码 如 下 : 
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常量 的 字面 意思 即 为 常量 的 作用 ， 比 如 STEP_REGISTER_P4SSWORD 常量 ， 用 来 标识 下 一 
步 操作 步骤 (操作 步骤 的 session 的 name 为 “step”) ， 当 用 户 选择 完 “ 用 户 注册 ”后 ， 系 统 将 
该 常量 设置 为 STEP_ REGISTER_USERNAME,， 那 下 一 步 用 户 输入 的 内 容 将 作为 用 户 名 保存 到 
session 中 ， 并 且 将 “step” 的 值 设置 为 STEP_REGISTER_P4SSWORD， 这 样 就 可 以 实现 会 话 的 功 
能 了 。 

微 信 公 众 号 开发 的 文档 中 开发 者 服务 器 只 能 提供 一 个 URL 地 址 与 公众 号 进行 交互 ， 所 以 
IndexController.class.php 只 需要 一 个 外 部 访问 的 操作 ， 本 文 使 用 index() 方 法 。 

由 于 用 户 关注 的 时 候 ， 微 信 会 推送 事件 到 该 URL， 所 以 我 们 需要 在 该 URL 中 返回 “欢迎 关 
注 ” 以 及 用 户 当 前 能 进行 的 操作 ， 比 如 在 用 户 关注 的 时 候 回 复 以 下 内 容 给 用 户 : 





14.5.1 ”注册 流程 


用 户 看 到 上 面 文字 会 明白 自己 当前 能 进行 3 个 操作 ， 一 次 注册 的 流程 如 下 《本 流程 只 演示 注 
册 ， 对 于 用 户 名 重复 检测 、 密 码 强度 检测 未 作 处 理 ， 有 兴趣 的 读者 可 以 自己 添加 》: 


Toi 当 用 户 回复 “1”", 则 系统 将 当前 的 step 设置 为 STEP_REGISTER_ USERNAME， 并且 
返回 响应 “【 注册 】 请 输入 用 户 名 ”。 

B02 当 用 户 继续 输入 非 999 的 内 容 时 ， 系 统 将 当前 用 户 输入 的 内 容 保 存 到 名 为 usemame 的 
session 中 ， 并 将 当前 的 step 设置 为 STEP_REGISTER_PASSWORD， 并 且 返 回响 应 
“【 注册 】 请 输入 密码 ”。 

B03 当 用 户 继续 输入 非 999 的 内 容 时 ， 系 统 将 当前 用 户 输入 的 内 容 保存 在 名 为 password 的 
session 中， 并重 置 当 前 的 step， 最 后 返回 以 下 响应 : 
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14.5.2 ”登录 流程 

登录 流程 大 致 上 和 注册 一 致 ， 只 不 过 在 用 户 输入 用 户 名 和 密码 的 时 候 将 当前 输入 的 值 与 
session 中 的 值 比较 ， 如 果 不 同 ， 则 返回 响应 “用 户 名 或 密码 错误 ”; 如 果 通 过 验证 ， 则 添加 一 
个 名 为 login 的 session， 值 为 1， 并 重 置 step。 最 后 返回 以 下 响应 : 





14.5.3 ”查看 个 人 资料 流程 


该 操作 需要 登录 ， 所 以 当 用 户 回复 “1” 时 需要 判断 是 否 登 录 ， 判 断 方法 为 检测 名 为 
“login” 的 session 值 ， 如 果 为 1， 则 返回 当前 用 户 的 个 人 资料 用 户 名 、 密 码 、 头 像 ， 头 像 值 
从 名 为 “avatar” 的 session 读 取 ， 如 果 不 存 在 ， 则 输出 “未 设置 头像 ”， 反 之 ， 则 输出 头像 图 片 
链接 地 址 ) ， 如 果 名 为 “login ”的 session 值 不 为 1， 则 进行 用 户 注册 逻辑 。 


14.5.4 ”上 传 头像 流程 


该 操作 需要 登录 ， 登 录 检 测 方法 与 “查看 个 人 资料 流程 ”一 致 ， 当 用 户 回复 “2” 时 ， 将 当 
前 的 “step” 设 置 为 STEP_AVATAR_UPLOAD， 并 返回 响应 “【 头 像 】 请 上 传 一 张 头 像 ”。 

如 果 当 前 的 “step” 为 STEP_AVATAR_UPLOAD， 且 当 用 户 继续 操作 时 输入 的 不 是 图 片 ， 
系统 直接 返回 响应 “【 头 像 】 操 作 有 误 ! 请 上 传 图 片头 像 ”。 

如 果 当 前 的 “step” 为 STEP_AVATAR_UPLOAD， 且 当前 的 消息 内 容 为 图 片 时 ， 将 用 户 输 
入 的 图 片 地 址 保存 到 名 为 “avatar” 的 session 中 ， 并 重 置 “step”， 最 后 返回 响应 “【 头 像 】 上 
传 成 功 ”。 
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14.5.5 ”退出 登录 流程 


该 操作 需要 登录 ， 登 录 检 测 方法 与 “查看 个 人 资料 流程 ”一 致 ， 当 用 户 回 复 “3 ”时 ， 将 名 
为 “login ”的 session 删除 ， 并 且 删 除名 为 “step” 的 session， 此 时 ， 用 户 登 录 信息 与 操作 步骤 


信息 已 经 完全 清除 ， 最 后 返回 以 下 响应 : 





14.5.6 ”全 局 回复 处 理 


当 任 何 情况 下 ， 用 户 回复 “999” 时 ， 此 时 用 户 要 求 完 全 重 置 会 话 状态 ， 所 以 系统 可 以 直接 
调用 session_destroy 方法 清空 当前 用 户 session。 


14.5.7 示例 代码 
完整 的 示例 代码 如 下 : 
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各 
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14.5.8 测试 


将 代码 部 署 到 服务 器 上 之 后 ， 打 开 微 信 测 试 公众 号 的 网 页 ， 找 到 “接口 配置 信息 ”， 填 写 服 
务 器 的 API 地 址 以 及 TOKEN (TOKEN 为 随机 字符 串 ， 用 来 对 微 信服 务 器 和 开发 者 服务 器 之 间 
的 数据 交互 做 安全 验证 ) 。 

微 信 扫 描 页 面 下 方 的 二 维 码 《请 读者 扫描 自己 的 公众 号 二 维 码 ) ， 如 图 13-4 所 示 。 





请 用 微 信 扫 描 关 注 测 试 公众 号 





图 13-4 


关注 之 后 ， 如 果 一 切 正常 ， 公 众 号 将 会 回复 预期 内 容 ， 此 时 ， 用 户 可 以 进行 各 项 功能 的 回复 
测试 。 
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1 4 .6 自 定义 菜单 开发 


14.6.1 获取 AccessToken 


主动 调用 微 信 的 接口 都 需要 使 用 access_ token， 而 access_token 每 天 有 调用 频率 限制 ， 基 于 
此 ， 亡 以 需要 使 用 缓存 ， 本 项 目 是 单 服务 器 ， 直 接 使 用 ThinkPHP 的 $ 方法 即 可 ，ThinkPHP 默 
认 使 用 文件 缓存 保存 数据 。 

通过 查阅 文档 可 以 获取 access_token 的 微 信 接口 地 址 ， 以 及 需要 的 参数 ， 直 接 传 入 即 可 。 首 
先 应 该 读 取 缓 存 中 是 否 有 ， 如 果 有 access_token， 则 直接 返回 ， 否则 请 求 微 信 服务 器 。 请 求 成 
功 ， 则 将 access_token 写 入 缓存 并 返回 : 反之 ， 则 报错 。 代 码 如 下 : 
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可 以 看 到 APPID 和 SECRET 使 用 的 是 配置 文件 中 配置 的 ， 而 且 缓 存 的 key 也 是 基于 
appid， 所 以 以 后 如 果 更 换 公众 号 只 需要 更 改 配置 文件 即 可 。 


14.6.2 ”创建 自 定义 菜单 


常用 的 自 定义 菜单 操作 有 “链接 ”和 “动作 ”两 种 。 

当 用 户 点 击 “ 链 接 ” 时 ， 微 信 会 打开 内 置 浏览 器 并 请 求 设置 的 链接 地 址 ， 同 时 ， 微 信服 务 器 
会 推送 “VIEW” 事 件 到 开发 者 服务 器 。 

当 用 户 点 击 “ 动 作 ” 时 ， 微 信 会 将 对 应 的 key 通过 事件 消息 推送 给 开发 者 服务 器 ， 开 发 者 通 
过 key 来 进行 相应 处 理 ， 并 将 响应 返回 。 代 码 如 下 : 
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可 以 看 到 该 方法 为 public， 所 以 该 接口 外 部 可 访问 ， 请 打开 浏览 器 在 本 地 请 求 
“http://localhost/thinkphp-inaction/wechat/home/index/menu”*， 如 果 请 求 成 功 ， 请 取消 关注 测试 公众 
号 并 重新 关注 测试 公众 号 (因为 微 信 的 自 定义 菜单 会 有 最 大 24 小 时 缓存 时 间 ， 为 了 及 时 生效 ， 
重新 关注 是 目前 最 好 的 办 法 ) 。 成 功 关注 后 可 以 看 到 公众 号 下 方 已 经 有 自 定义 菜单 了 。 如 果 请 求 
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失败 ， 浏 览 器 会 直接 显示 具体 的 错误 信息 ， 各 位 读者 可 以 参照 微 信 的 错误 码 进 行 相应 处 理 。 


14.6.3 ”响应 自 定义 菜单 


当 用 户 点 击 “ 动 作 ” 类 型 的 菜单 项 时 ， 微 信 会 推送 事件 到 开发 者 服务 器 ， 这 时 候 我 们 需要 对 
该 事件 进行 处 理 ， 代 码 如 下 : 





本 项 目 只 体验 接口 流程 ， 所 以 并 没有 实际 的 业务 逻辑 ， 这 样 便于 大 家 直接 理解 公众 号 的 功能 
开发 ， 只 有 理解 完 最 简单 的 流程 之 后 ， 才 可 以 开发 更 高 级 的 功能 ， 比 如 结合 数据 库 进行 开发 等 。 


14.7 项 目 总 结 


本 项 目 起 到 一 个 抛砖引玉 的 作用 ， 和 希望 各 位 读者 都 能 将 本 章节 的 内 容 理解 清楚 ， 这 样 才能 在 
以 后 的 开发 中 更 加 顺利 。 
本 章节 的 逻辑 部 分 代码 都 在 Application/Home/Controller/IndexController.class.php 中 。 


项 目 已 托管 至 github， 地 址 为 : 
https://github.com/xialeistudio/thinkphp-inaction/tree/master/wechat 


如 有 任何 问题 请 提交 issues， 地 址 为 : 
https://github.com/xialeistudio/thinkphp-inaction/issues。 
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介绍 完 ThinkPHP 的 知识 后 ， 通 过 使 用 ThinkPHP 开发 几 个 实际 的 项 目 ， 目 的 只 有 一 个 “ 实 
践 是 检验 真理 的 唯一 标准 ”， 只 有 实际 的 项 目 才能 让 读者 明白 ThinkPHP 的 项 目 开发 流程 。 

如 果 大 家 在 学 习 的 过 程 中 遇 到 问题 ， 请 提交 问题 到 github， 有 时 间 我 将 为 各 位 一 一 解答 ， 让 
各 位 读者 更 好 地 用 好 ThinkPHP 框架 。 

最 后 引用 ThinkPHP 框架 的 一 句 名 言 “ 大 道 至 简 ， 开 发 由 我 ”! 祝 各 位 读者 在 以 后 的 工作 中 
更 加 顺利 ! 


